More than 5 years have passed since last update.

groongaをコマンドラインから便利に使うには

groonga

Posted at 2013-07-18

もっとgroongaを知ってもらおう!ということで週刊groongaをはじめました。毎週木曜にgroongaやmroonga、rroongaのトピックを投稿予定です。

いよいよ、gihyo.jpさんでgroongaの隔週更新連載が始まりました!!
第7回の記事も公開されたので、一読をおすすめします。

「第7回 [実録] MySQL向け全文検索エンジン「Tritonn」から「mroonga」への移行ガイド（2）」

第1回から第6回までの過去記事については、隔週連載groongaのページを参照してください。

はじめに

オープンソースのカラムストア機能付き全文検索エンジンgroongaを公開しています。

最新のバージョンは2013年6月29日にリリースした3.0.5です。

今回は、groongaをコマンドラインから便利に使う方法を紹介します。

groongaをコマンドラインから使う

groongaをコマンドラインから使うといったときには、以下の2つのタイプがあるでしょう。

コマンドラインで便利に使う
対話モードで便利に使う

前者はgroongaコマンドのオプションをあれこれ指定するような場合です。
後者はgroongaコマンドを実行し、対話モードに入ってからクエリを実行するような場合です。

それぞれのタイプ向けに便利に使う方法があるので以下に紹介します。

コマンドラインで便利に使う

このタイプでは、シェルの持つ補完機能を拡張するというものがあります。

Zshの補完関数

Zshを普段使っているのであれば、hhattoさんの書かれたZshの補完関数があります。
補完関数の紹介記事はgroongaのZsh補完関数を書きましたです。

以下のURLにアクセスすると実際の補完関数を参照することができます。(groonga以外にもあれこれと補完関数があります。)

https://github.com/hhatto/zsh_completions/

ご自身のZsh環境に合わせて補完関数を導入してみると良いでしょう。groongaの各種オプションを補完できるようになります。

対話モードで便利に使う

groongaコマンド自体はシンプルなつくりなので、対話モードにて履歴機能などは標準では付属していません。
この対話モードを便利に使う方法は以下のようにいくつかあります。

rlwrap

履歴機能等を使えるようにするよく知られた方法としてrlwrapを使う方法があります。
rlwrapはreadlineを使うことでその機能を提供しています。
以下のようにgroongaコマンドを実行することで、履歴機能が対話モードでも使えるようになります。

% rlwrap groonga

grnwrap

rlwrapと同じようにreadlineを使うことで履歴機能やカーソル移動を実現するのがgrnwrapです。
rlwrapは汎用的ですが、grnwrapはよりgroongaに特化した機能を提供しています。

詳細はGroongaの対話モードをラップするgrnwrap - from future import nowhere @ はてなにありますが、

タブキーでコマンド名、引数名、テーブル名、ファイルパスの補完
JSONのインデント表示
Gオプションでselectの結果をMySQLの\G風にフォーマット
*.grnなファイルパスを入力するとファイルに書かれたGroongaコマンドを実行

などが使えるようになります。
デフォルトのgroongaのパスが/usr/local/bin/groongaになっていたり、最近追加/削除したコマンドには対応していない点に注意する必要がありますが、結果のインデント表示がサポートされているところは嬉しいポイントです。

MySQLの\G風表示は以下のようになります。

% grnwrap -G testdb/db
> select Video
******************************* 1. row *******************************
     _id: 1
    _key: 1
    tags: [u'demo application', u'groonga', u'FTS']
   title: groonga Demo
******************************* 2. row *******************************
     _id: 2
    _key: 2
    tags: [u'demo', u'mroonga', u'FTS']
   title: mroonga Demo
******************************* 3. row *******************************
     _id: 3
    _key: 3
    tags: [u'demo', u'rroonga', u'FTS', u'ruby']
   title: rroonga Demo
******************************* 4. row *******************************
     _id: 4
    _key: 4
    tags: [u'presentation', u'groonga', u'FTS']
   title: groonga Overview
4 records / 4 hits (0.000592947006226 sec)

JSONのインデント表示は以下のようになります。(長いので途中で省略)

% grnwrap testdb/db
> select Video
[
    [
        0, 
        1374115250.31744, 
        0.00024867057800293
    ], 
    [
        [
            [
                4
            ], 
            [
                [
                    "_id", 
                    "UInt32"
                ], 
                [
                    "_key", 
                    "UInt32"
                ], 
                [
                    "tags", 
                    "Tag"
                ], 
                [
                    "title", 
                    "ShortText"
                ]
            ], 
            [
                1, 
                1, 
                [
                    "demo application", 
                    "groonga", 
                    "FTS"
                ], 
                "groonga Demo"
            ],