Groongaのチュートリアルを試してみた

2015-04-26

Groongaのチュートリアルを試してみたメモです。試した環境は Groonga 5.0.2, Ubuntu 14.04.2 です。

セットアップ手順

2.4. Ubuntu — Groonga v5.0.2ドキュメントにそってセットアップしました。

セットアップ手順はDockerfileにまとめておきました。

さらにVirtualBox + VagrantでUbuntuにdockerとdocker-composeをインストールして、上のDockerfileでコンテナを作る手順を自動化するVagrantfileを作成して hnakamur/groonga-dockerfiles で公開しています。

VirtualBoxとVagrantをインストールしてあれば、以下の手順ですぐ試せます。

git clone https://github.com/hnakamur/groonga-dockerfiles
cd groonga-dockerfiles
vagrant up

起動後コンテナを作って起動するまでには結構時間がかかります。

$ vagrant ssh

でVMにログインして、以下のようにCommandでgroonga-httpdが実行されたら起動完了です。

$ cd /vagrant/dockerfiles
$ sudo docker-compose ps
      Name             Command             State              Ports
-------------------------------------------------------------------------
dockerfiles_groo   /usr/sbin          Up                 0.0.0.0:80->1004
ngatrusty_1        /groonga-httpd                        1/tcp
                   -g ...

管理画面とgroongaコマンドの起動方法

http://192.168.33.12/ でgroongaの管理画面にアクセスできます。

groongaコマンドの起動方法は以下の通りです。

vagrant ssh

でVMにログインし、

sudo docker exec -it dockerfiles_groongatrusty_1 /bin/bash

でコンテナ内に入り

sudo -u groonga groonga /var/lib/groonga/db/db

でgroongaコマンドを実行します。

groongaコマンドの実行ユーザをrootにするとハマるので注意

groongaコマンドはgroongaで実行するのが重要です。

rootユーザで実行してしまうとエラーにはならないのですが、テーブルなどを作成してもgroongaの管理画面で表示されずハマりました。

groongaのデータベースは最初は1つのファイルですが、テーブルなどを作るとファイルが追加で作成されます。

root@b95446c72160:/# cd /var/lib/groonga/db
root@b95446c72160:/var/lib/groonga/db# ll
total 15332
drwxr-xr-x 2 groonga groonga     4096 Apr 26 14:34 ./
drwxr-xr-x 3 groonga groonga     4096 Apr 26 01:49 ../
-rw-r--r-- 1 groonga groonga     4096 Apr 26 14:33 db
-rw-r--r-- 1 groonga groonga 21245952 Apr 26 14:33 db.0000000
-rw-r--r-- 1 groonga groonga 16842752 Apr 26 14:34 db.0000100
-rw-r--r-- 1 groonga groonga 12857344 Apr 26 14:26 db.0000101
-rw-r--r-- 1 groonga groonga  8437760 Apr 26 14:28 db.0000102
-rw-r--r-- 1 groonga groonga  1085440 Apr 26 14:28 db.0000103
-rw-r--r-- 1 groonga groonga  4198400 Apr 26 14:28 db.0000103.c
-rw-r--r-- 1 groonga groonga  8437760 Apr 26 14:34 db.0000104
-rw-r--r-- 1 groonga groonga  4198400 Apr 26 14:34 db.0000105
-rw-r--r-- 1 groonga groonga  1085440 Apr 26 14:34 db.0000106
-rw-r--r-- 1 groonga groonga  4198400 Apr 26 14:34 db.0000106.c
-rw-r--r-- 1 groonga groonga  1048576 Apr 26 14:34 db.001

rootユーザでgroongaコマンドを実行すると作成されたファイルの所有者がrootユーザになり、groonga-httpdから見えないようです。

chown groonga: /var/lib/groonga/db/db* で所有者をgroongaユーザに変更すれば見えるようになりました。

ということで、上記のようにgroongaユーザでgroongaコマンドを実行するのが良いです。

チュートリアルの一部手順でエラーが出てハマった

4. チュートリアル — Groonga v5.0.2ドキュメントの手順で試してみました。ほとんどはすんなり実行できましたが、1箇所ハマりました。

インデックス付きジオサーチのところでnonexistent sourceというエラー

4.6.3. インデックス付きジオサーチのところで以下の様なエラーが出ました。

> table_create --name GeoIndex --flags TABLE_PAT_KEY --key_type WGS84GeoPoint
[[0,1429178015.01179,0.00191092491149902],true]
> column_create --table GeoIndex --name index_point --type Site --flags COLUMN_INDEX --source location
[[-22,1429178020.73797,0.00554323196411133,"[column][create] nonexistent source: <location>",[["proc_column_create_resolve_source_name","proc.c",1774]]],false]

Siteテーブルは4.1.5. テーブルの作成で

table_create --name Site --flags TABLE_HASH_KEY --key_type ShortText

として作成していますが、その後 location カラムを作る箇所がなかったようです。

2015-04-28追記 https://twitter.com/kenhys/status/592901925089189889 でご指摘いただいたのですが、実は4.4.3. 位置情報を用いた絞込・ソートで location カラムを作っているのを私が見落としていました。失礼いたしました。

column_create --table Site --name location --type WGS84GeoPoint

のようにカラムを作成すれば大丈夫でした。

table_create --name GeoIndex --flags TABLE_PAT_KEY --key_type WGS84GeoPoint
column_create --table GeoIndex --name index_point --type Site --flags COLUMN_INDEX --source location

でインデクス用のテーブルとカラムを作成して、

load --table Site
[
 {"_key":"http://example.org/","location":"128452975x503157902"},
 {"_key":"http://example.net/","location":"128487316x502920929"}
]

で、データをロードします。

> select --table Site --filter 'geo_in_circle(location, "128515259x503187188", 5000)' --output_columns _key,location
[[0,1430061299.24235,0.00105690956115723],[[[1],[["_key","ShortText"],["location","WGS84GeoPoint"]],["http://example.org/","128452975x503157902"]]]]

で検索できました。

まとめ

2箇所ハマりましたが解決してとりあえず使えるようになりました。今後さらに調査していきたいと思います。