もっとGroongaを知ってもらおう!ということで週刊Groongaをはじめました。毎週木曜にGroongaやMroonga、Rroongaのトピックを投稿予定です。
いよいよ、gihyo.jpさんでGroongaの隔週更新連載が始まりました!!
第2回の記事も公開されたので、一読をおすすめします。
連載は始まりましたが、利用事例をどんどん紹介していきたいので、GroongaやMroonga、Rroongaを実際に使っていて、利用事例記事を書いてもいいよ、という人をまだまだ募集しています。
詳細はGroonga普及のための協力のお願いを参照してください。
はじめに
オープンソースのカラムストア機能付き全文検索エンジンGroongaを公開しています。
最新のバージョンは2013年3月29日にリリースした3.0.2です。
今回は、Groongaでブラウザベースの管理ツールを使う方法について紹介します。
ブラウザベースの管理ツール
Groongaには、ブラウザベースの管理ツールが付属しています。
GroongaをHTTPサーバとして起動しているときは、ブラウザベースの管理ツールを使うことにより、データベースを簡単に管理することができます。管理ツールを使いたいときは、ブラウザを使って http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/ へとアクセスしてください。管理ツールの使用には、JavaScriptの実行が有効になっている必要があります。
このブラウザベースの管理ツールを使うには、例えばブラウザを起動してから、http://localhost:10041/へとアクセスします。
あらかじめGroongaを起動しておく必要があるので、そのあたりの手間をかけずに簡単に使うには、サーバーパッケージをインストールして環境を用意するのがおすすめです。
サーバーパッケージのインストール
まずは、お使いの環境ごとにGroongaをインストールします。
今回は、簡易HTTPサーバー機能を提供する、groonga-server-http を使うことにします。
以下は、Ubuntuでの導入例です。他のディストリビューションをお使いのかたは適宜読み替えて下さい。
sudo apt-get install groonga-server-http
サーバーパッケージをインストールすると自動的にGroongaがサーバーとして起動します。
例えば、以下のようにしてGroongaが起動していることを確認できます。
% ps -ef|grep groonga
groonga 2735 1 0 09:50 ? 00:00:00 /usr/sbin/fcgiwrap
khayashi 8233 3823 0 10:46 pts/5 00:00:00 \_ grep groonga
root 7937 1 0 10:29 ? 00:00:00 /usr/bin/groonga -d --pid-path /var/run/groonga/groonga-http.pid --bind-address 127.0.0.1 --port 10041 --log-path /var/log/groonga/groonga-http.log --query-log-path /var/log/groonga/query-http.log --protocol http /var/lib/groonga/db/db
管理ツールを使う
それでは、実際に管理ツールを使ってみましょう。
ブラウザを起動し、http://localhost:10041へとアクセスします。
-
画面一覧
- サマリー
- サジェスト
テーブル一覧
上記のように画面一覧とテーブル一覧のメニューがあり、画面一覧にはサマリーとサジェストというサブメニューがあります。
まだ、テーブルを作成していないので、テーブル一覧には何もありません。
それでは、テーブル作成から始めてみましょう。
テーブルを作成するには、サマリー画面からテーブル作成タブを選択します。
サンプルとして、チュートリアルをやってみましょう。
テーブルのスキーマ定義は、以下の通りです。
table_create --name Site --flags TABLE_HASH_KEY --key_type ShortText
管理ツールでも同様に指定すると以下のようになります。
テーブル追加ボタンをクリックすると、テーブルを作成できます。
テーブル一覧にも追加したSiteテーブルが表示されていますね。
次にカラムの定義を追加しましょう。
カラムの定義は以下の通りです。
column_create --table Site --name title --type ShortText
管理ツールでも同様に指定すると以下のようになります。
作成したカラムはカラム一覧から確認できます。
あとは、レコード作成画面でデータを登録していきます。
登録したレコードは、レコード一覧で確認できます。
では、実際に検索してみましょう。
チュートリアルの検索のクエリは以下の通りでした。これは登録したレコードが1であるレコードを検索します。
select --table Site --query _id:1
検索クエリ欄に、_id:1と入力して、検索ボタンをクリックします。
きちんと、idが1であるレコードを検索できました。
まとめ
今回はGroongaでブラウザベースの管理ツールを使う方法を紹介しました。
コマンドラインで作業するほうがたいていの場合効率が良いので、あまり知られていない&詳しく説明していない管理ツールをスクリーンショットつきで紹介してみました。
最初のとっかかりとしてはブラウザから管理ツールを操作するほうがわかりやすいという場合もあると思います。
今回の例としてあげた部分はチュートリアルのほんのさわり部分だけです。まだまだ続きがあります。
Groongaの基本的な動作を知りたいというのであれば、チュートリアルの続きを試してみてください。