rroonga 0.9.5-x86-mingw32 → 1.0.1-x86-mingw32

data/vendor/local/share/groonga/doc/ja/source/tutorial/tutorial04.txt

@@ -0,0 +1,111 @@
+.. highlightlang:: none
+
+.. groonga-include : tutorial03.txt
+
+さまざまな検索条件の指定
+========================
+
+groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。
+
+JavaScriptに似た文法での絞込・全文検索
+--------------------------------------
+
+selectコマンドのfilterパラメータは、queryパラメータと同様に、レコードの検索条件を指定します。filterパラメータとqueryパラメータが異なる点は、filterパラメータには、JavaScriptの式に似た文法で条件を指定する点です。
+
+.. groonga-command
+.. include:: ../example/tutorial04-1.log
+.. select --table Site --filter "_id <= 1" --output_columns _id,_key
+
+ここで、filterパラメータには
+
+  _id <= 1
+
+という条件を指定しています。この場合は_idの値が1以下のレコードが検索結果として得られます。
+
+また、&& や || を使って、条件のAND・OR指定をすることもできます。
+
+.. groonga-command
+.. include:: ../example/tutorial04-2.log
+.. select --table Site --filter "_id >= 4 && _id <= 6" --output_columns _id,_key
+.. select --table Site --filter "_id <= 2 || _id >= 7" --output_columns _id,_key
+
+queryパラメータとfilterパラメータを同時に指定すると、両者の条件をともに満たすレコードが結果として返ります。
+
+scorerを利用したソート
+----------------------
+
+selectコマンドのscorerパラメータは、
+全文検索を行った結果の各レコードに対して処理を行うためのパラメータです。
+
+filterパラメータと同様に、
+JavaScriptの式に似たな文法で様々な条件を指定することができます。
+
+.. groonga-command
+.. include:: ../example/tutorial04-3.log
+.. select --table Site --filter "1" --scorer "_score = rand()" --output_columns _id,_key,_score --sortby _score
+.. select --table Site --filter "1" --scorer "_score = rand()" --output_columns _id,_key,_score --sortby _score
+
+検索結果には、'_score'という名前の、全文検索のスコアが代入されている仮想的なカラムが付与されることをチュートリアル中ソートの項目で説明しました。
+
+上記の実行例では、scorerパラメータに
+
+ _score = rand()
+
+という条件を指定しています。ここでは、rand()という乱数を返す関数を用いて、全文検索のスコアを乱数で上書きしています。
+
+sortbyパラメータには、
+
+ _score
+
+を指定しています。これは、スコア順に昇順にソートすることを意味しています。
+
+よって、上記のクエリは実行されるたびに検索結果の並び順がランダムに変わります。
+
+位置情報を用いた絞込・ソート
+----------------------------
+
+groongaでは、位置情報（経緯度）を保存することができます。また、保存した経緯度を用いて絞込やソートができます。
+
+位置情報を保存するためのカラムの型として、TokyoGeoPoint/WGS84GeoPointの２つの型があります。前者は日本測地系、後者は世界測地系(WGS84相当)の経緯度を保存します。
+
+経緯度をデータを入力するためには、"緯度のミリ秒x経度のミリ秒"という形式の文字列を代入する必要があります。
+
+ここでは、ためしに東京駅と新宿駅とついて、世界測地系での位置情報を保存してみましょう。東京駅は緯度が35度40分52.975秒、経度が139度45分57.902秒です。新宿駅は緯度が35度41分27.316秒、経度が139度42分0.929秒です。よって、代入する文字列はそれぞれ"128452975x503157902"/"128487316x502920929"となります。
+
+.. groonga-command
+.. include:: ../example/tutorial04-4.log
+.. column_create --table Site --name location --type WGS84GeoPoint
+.. load --table Site
+.. [
+..  {"_key":"http://example.org/","location":"128452975x503157902"}
+..  {"_key":"http://example.net/","location":"128487316x502920929"},
+.. ]
+.. select --table Site --query "_id:1 OR _id:2" --output_columns _key,location
+
+scorerパラメータにおいて、 :doc:`../functions/geo_distance` 関数を用いることにより、２点間の距離を計算することができます。
+
+ここでは、秋葉原駅からの距離を表示させてみましょう。世界測地系では、秋葉原駅の位置は緯度が35度41分55.259秒、経度が139度46分27.188秒です。よって、geo_distance関数に与える文字列は"128515259x503187188"となります。
+
+.. groonga-command
+.. include:: ../example/tutorial04-5.log
+.. select --table Site --query "_id:1 OR _id:2" --output_columns _key,location,_score --scorer '_score = geo_distance(location, "128515259x503187188")'
+
+この結果を見ると、東京駅と秋葉原駅は2054m、秋葉原駅と新宿駅は6720m離れているようです。
+
+geo_distance関数は、_scoreを通じてソートでも用いることができます。
+
+.. groonga-command
+.. include:: ../example/tutorial04-6.log
+.. select --table Site --query "_id:1 OR _id:2" --output_columns _key,location,_score --scorer '_score = geo_distance(location, "128515259x503187188")' --sortby -_score
+
+「ある地点から何m以内に存在する」といった絞込も可能です。
+
+filterパラメータにおいて、 :doc:`../functions/geo_in_circle` 関数を用いることにより、２点間の距離が指定のm以下におさまるかどうかを判定することができます。
+
+たとえば、秋葉原駅から5000m以内にあるレコードを検索してみましょう。
+
+.. groonga-command
+.. include:: ../example/tutorial04-7.log
+.. select --table Site --output_columns _key,location --filter 'geo_in_circle(location, "128515259x503187188", 5000)'
+
+また、経緯度が指定の矩形領域内であるかどうかを判定する :doc:`../functions/geo_in_rectangle` 関数も存在します。

data/vendor/local/share/groonga/doc/ja/source/tutorial/tutorial05.txt

@@ -0,0 +1,65 @@
+.. highlightlang:: none
+
+.. groonga-include : tutorial04.txt
+.. groonga-command
+.. table_remove SiteDomain
+.. table_remove SiteCountry
+
+
+ドリルダウン
+============
+
+groongaでは、特定のカラム値で検索結果をグループ化することができます。これをドリルダウンと呼びます。
+
+Siteテーブルに２つのカラムを追加します。TLDドメイン名を格納するdomainカラムと、国名を格納するcountryカラムです。これらのカラムの型は、それぞれドメイン名を主キーとするSiteDomainテーブルと、国名を主キーとするSiteCounteryテーブルとします。
+
+.. groonga-command
+.. include:: ../example/tutorial05-1.log
+.. table_create --name SiteDomain --flags TABLE_HASH_KEY --key_type ShortText
+.. table_create --name SiteCountry --flags TABLE_HASH_KEY --key_type ShortText
+.. column_create --table Site --name domain --flags COLUMN_SCALAR --type SiteDomain
+.. column_create --table Site --name country --flags COLUMN_SCALAR --type SiteCountry
+.. load --table Site
+.. [
+.. {"_key":"http://example.org/","domain":".org","country":"japan"},
+.. {"_key":"http://example.net/","domain":".net","country":"brazil"},
+.. {"_key":"http://example.com/","domain":".com","country":"japan"},
+.. {"_key":"http://example.net/afr","domain":".net","country":"usa"},
+.. {"_key":"http://example.org/aba","domain":".org","country":"korea"},
+.. {"_key":"http://example.com/rab","domain":".com","country":"china"},
+.. {"_key":"http://example.net/atv","domain":".net","country":"china"},
+.. {"_key":"http://example.org/gat","domain":".org","country":"usa"},
+.. {"_key":"http://example.com/vdw","domain":".com","country":"japan"}
+.. ]
+
+domainカラムとcountryカラムでドリルダウンを行う例を以下に示します。
+
+.. groonga-command
+.. include:: ../example/tutorial05-2.log
+.. select --table Site --limit 0 --drilldown domain
+
+テーブル型を持つカラムに対してドリルダウンを行った場合、参照先のテーブルに存在するカラム値を取得することもできます。ドリルダウンを行ったテーブルには、_nsubrecsという仮想的なカラムが追加されます。このカラムには、グループ化されたレコード数が入ります。
+
+.. groonga-command
+.. include:: ../example/tutorial05-3.log
+.. select --table Site --limit 0 --drilldown domain --drilldown_output_columns _id,_key,_nsubrecs
+
+複数のカラムに対してドリルダウンを行うことができます。複数のカラムに対してドリルダウンを行う場合には、drilldownパラメータにカラム名をカンマ区切りで与えます。
+
+.. groonga-command
+.. include:: ../example/tutorial05-4.log
+.. select --table Site --limit 0 --drilldown domain,country
+
+ドリルダウン結果を並びかえることができます。例えば、_nsubrecsパラメータの降順で並び替えることができます。
+
+.. groonga-command
+.. include:: ../example/tutorial05-5.log
+.. select --table Site --limit 0 --drilldown country --drilldown_sortby _nsubrecs
+
+ドリルダウン結果は、デフォルトでは10件のみ表示されます。drilldown_offsetパラメータと、drilldown_limitパラメータによって、offsetとlimitを指定することができます。
+
+.. groonga-command
+.. include:: ../example/tutorial05-6.log
+.. select --table Site --limit 0 --drilldown country --drilldown_sortby _nsubrecs --drilldown_limit 2 --drilldown_offset 2
+
+文字列型のカラムに対するドリルダウンは、他の型でのドリルダウンに比べて低速です。文字列でのドリルダウンを行いたい場合には、このチュートリアルのように、文字列型を主キーとするテーブルを別途作成し、そのテーブルを型とするカラムを作成します。

data/vendor/local/share/groonga/doc/ja/source/tutorial/tutorial06.txt

@@ -0,0 +1,91 @@
+.. highlightlang:: none
+
+.. groonga-include : tutorial05.txt
+
+タグ検索・参照関係の逆引き
+==========================
+
+本チュートリアルで、groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。
+
+タグ検索はgroongaの転置インデックスというデータ構造を用いて高速に行われます。
+
+タグ検索
+--------
+
+動画共有サイトの検索エンジンを作ることを想定します。1つの動画には、その動画の特徴を表す、複数の語句が付与されています。「ある語句が付与されている動画の一覧を取得する」検索を行いたいとします。
+
+実際に、動画情報のテーブルを作成し、検索をしてみましょう。
+
+動画の情報を保存する、Videoテーブルを作成します。Videoテーブルでは、動画のタイトルをtitleカラムに、動画のタグ情報をtagsカラムにTagテーブル型で複数格納しています。
+タグの情報を保存する、Tagテーブルを作成します。Tagテーブルでは、タグ文字列を主キーに格納し、Videoテーブルのtagsカラムに対するインデックスをindex_tagsカラムに格納しています。
+
+.. groonga-command
+.. include:: ../example/tutorial06-1.log
+.. table_create --name Video --flags TABLE_HASH_KEY --key_type UInt32
+.. table_create --name Tag --flags TABLE_HASH_KEY --key_type ShortText
+.. column_create --table Video --name title --flags COLUMN_SCALAR --type ShortText
+.. column_create --table Video --name tags --flags COLUMN_VECTOR --type Tag
+.. column_create --table Tag --name index_tags --flags COLUMN_INDEX --type Video --source tags
+.. load --table Video
+.. [
+.. {"_key":1,"title":"Soccer 2010","tags":["Sports","Soccer"]},
+.. {"_key":2,"title":"Zenigata Kinjirou","tags":["Variety","Money"]},
+.. {"_key":3,"title":"groonga Demo","tags":["IT","Server","groonga"]},
+.. {"_key":4,"title":"Moero!! Ultra Baseball","tags":["Sports","Baseball"]},
+.. {"_key":5,"title":"Hex Gone!","tags":["Variety","Quiz"]},
+.. {"_key":6,"title":"Pikonyan 1","tags":["Animation","Pikonyan"]},
+.. {"_key":7,"title":"Draw 8 Month","tags":["Animation","Raccoon"]},
+.. {"_key":8,"title":"K.O.","tags":["Animation","Music"]}
+.. ]
+
+インデックスカラムを作成すると、全文検索が高速に行えるようになります。インデックスカラムは、対象のカラムに保存されたデータに更新があったとき、自動的に更新されます。
+
+「ある語句が付与されている動画の一覧を取得する」検索を行いましょう。
+
+.. groonga-command
+.. include:: ../example/tutorial06-2.log
+.. select --table Video --query tags:@Variety --output_columns _key,title
+.. select --table Video --query tags:@Sports --output_columns _key,title
+.. select --table Video --query tags:@Animation --output_columns _key,title
+
+このように、「Variety」、「Sports」、「Animation」のようなタグで検索を行うことができました。
+
+参照関係の逆引き
+----------------
+
+groongaはテーブル間の参照関係の逆引きを高速に行うためのインデックスを付与することができます。タグ検索は、その1例にすぎません。
+
+例えば、ソーシャルネットワーキングサイトにおける友人関係を逆引き検索することができます。
+
+以下の例では、ユーザー情報を格納するUserテーブルを作成し、ユーザー名を格納するusernameカラム、ユーザーの友人一覧を配列で格納するfriendsカラムとそのインデックスのindex_friendsカラムを追加しています。
+
+.. groonga-command
+.. include:: ../example/tutorial06-3.log
+.. table_create --name User --flags TABLE_HASH_KEY --key_type ShortText
+.. column_create --table User --name username --flags COLUMN_SCALAR --type ShortText
+.. column_create --table User --name friends --flags COLUMN_VECTOR --type User
+.. column_create --table User --name index_friends --flags COLUMN_INDEX --type User --source friends
+.. load --table User
+.. [
+.. {"_key":"ken","username":"健作","friends":["taro","jiro","tomo","moritapo"]}
+.. {"_key":"moritapo","username":"森田","friends":["ken","tomo"]}
+.. {"_key":"taro","username":"ぐるんが太郎","friends":["jiro","tomo"]}
+.. {"_key":"jiro","username":"ぐるんが次郎","friends":["taro","tomo"]}
+.. {"_key":"tomo","username":"トモちゃん","friends":["ken","hana"]}
+.. {"_key":"hana","username":"花子","friends":["ken","taro","jiro","moritapo","tomo"]}
+.. ]
+
+指定したユーザーを友人リストに入れているユーザーの一覧を表示してみましょう。
+
+.. groonga-command
+.. include:: ../example/tutorial06-4.log
+.. select --table User --query friends:@tomo --output_columns _key,username
+.. select --table User --query friends:@jiro --output_columns _key,username
+
+さらに、ドリルダウンを使って、友人リストに入っている数の一覧を表示してみましょう。
+
+.. groonga-command
+.. include:: ../example/tutorial06-5.log
+.. select --table User --limit 0 --drilldown friends
+
+このように、テーブルの参照関係を逆にたどる検索ができました。

data/vendor/local/share/groonga/doc/ja/source/tutorial/tutorial07.txt

@@ -0,0 +1,92 @@
+.. highlightlang:: none
+
+.. groonga-command
+.. table_remove Blog1
+.. table_remove IndexBlog1
+.. table_remove Blog2
+.. table_remove IndexBlog2
+
+match_columnsパラメータ
+=======================
+
+複数のカラムを対象とした全文検索
+--------------------------------
+
+groongaでは、複数のカラムを対象とした全文検索を行うことができます。例えば、ブログのテーブルで、タイトルと内容とがそれぞれ別のカラムに入ったものがあるとしましょう。「タイトルもしくは内容に特定の単語を含む」検索を行いたいとします。
+
+この場合、2つのインデックス作成方式があります。1つは、それぞれのカラムに1つずつインデックスを付与する方式です。もう1つは、複数のカラムに対して1つのインデックスを付与する方式です。groongaでは、どちらの形式のインデックスが存在している場合でも、同一の記法で全文検索を行うことができます。
+
+カラムごとにインデックスを付与する場合
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Blog1テーブルを作り、タイトル文字列のtitleカラム、本文のmessageカラムを追加しています。
+インデックス用のIndexBlog1テーブルも作り、titleカラムのインデックス用にindex_titleカラム、messageカラムのインデック用にindex_messageカラムと、それぞれ1カラムごとに1つずつ追加しています。
+
+.. groonga-command
+.. include:: ../example/tutorial07-1.log
+.. table_create --name Blog1 --flags TABLE_HASH_KEY --key_type ShortText
+.. column_create --table Blog1 --name title --flags COLUMN_SCALAR --type ShortText
+.. column_create --table Blog1 --name message --flags COLUMN_SCALAR --type ShortText
+.. table_create --name IndexBlog1 --flags TABLE_PAT_KEY|KEY_NORMALIZE --key_type ShortText --default_tokenizer TokenBigram
+.. column_create --table IndexBlog1 --name index_title --flags COLUMN_INDEX|WITH_POSITION --type Blog1 --source title
+.. column_create --table IndexBlog1 --name index_message --flags COLUMN_INDEX|WITH_POSITION --type Blog1 --source message
+.. load --table Blog1
+.. [
+.. {"_key":"grn1","title":"groonga test","message":"groonga message"},
+.. {"_key":"grn2","title":"baseball result","message":"rakutan eggs 4 - 4 groonga moritars"},
+.. {"_key":"grn3","title":"groonga message","message":"none"}
+.. ]
+
+match_columnsオプションで、検索対象のカラムを複数指定することが出来ます。検索する文字列はqueryオプションで指定します。これを使うことで、タイトルと本文を全文検索することができます。
+
+実際に検索してみましょう。
+
+.. groonga-command
+.. include:: ../example/tutorial07-2.log
+.. select --table Blog1 --match_columns title||message --query groonga
+.. select --table Blog1 --match_columns title||message --query message
+.. select --table Blog1 --match_columns title --query message
+
+複数のカラムにまたがったインデックスを付与する場合
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+内容は上の例とほぼ同じですが、titleとmessageの2つのカラムに対するインデックスが共通になっており、インデックスカラムが1つしかありません。
+
+共通のインデックスを用いても、titleカラムのみでの検索、messageカラムのみでの検索、titleもしくはmessageカラムでの検索、全ての検索を行うことができます。
+
+
+.. groonga-command
+.. include:: ../example/tutorial07-3.log
+.. table_create --name Blog2 --flags TABLE_HASH_KEY --key_type ShortText
+.. column_create --table Blog2 --name title --flags COLUMN_SCALAR --type ShortText
+.. column_create --table Blog2 --name message --flags COLUMN_SCALAR --type ShortText
+.. table_create --name IndexBlog2 --flags TABLE_PAT_KEY|KEY_NORMALIZE --key_type ShortText --default_tokenizer TokenBigram
+.. column_create --table IndexBlog2 --name index_blog --flags COLUMN_INDEX|WITH_POSITION|WITH_SECTION --type Blog2 --source title,message
+.. load --table Blog2
+.. [
+.. {"_key":"grn1","title":"groonga test","message":"groonga message"},
+.. {"_key":"grn2","title":"baseball result","message":"rakutan eggs 4 - 4 groonga moritars"},
+.. {"_key":"grn3","title":"groonga message","message":"none"}
+.. ]
+
+実際に検索してみましょう。結果は上の例と同じになります。
+
+.. groonga-command
+.. include:: ../example/tutorial07-4.log
+.. select --table Blog2 --match_columns title||message --query groonga
+.. select --table Blog2 --match_columns title||message --query message
+.. select --table Blog2 --match_columns title --query message
+
+インデックス名を指定した全文検索
+--------------------------------
+
+執筆中です。
+
+.. TODO: match_columnsにインデックス名を指定しての検索についても触れる。
+
+インデックスの重み
+------------------
+
+執筆中です。
+
+.. TODO: match_columnsの重み指定機能についても触れる。

data/vendor/local/share/groonga/doc/ja/source/tutorial/tutorial08.txt

@@ -0,0 +1,53 @@
+.. highlightlang:: none
+
+.. groonga-command
+.. table_remove PatPre
+
+主キーによる前方一致検索
+========================
+
+groongaのテーブルは、テーブル作成時にパトリシア木オプションを指定すると、前方一致検索を行うことができます。また、追加のオプションを指定することにより、主キーの後方一致検索をも行うことができます。
+
+主キーによる前方一致検索
+------------------------
+
+table_createコマンドのflagsオプションにTABLE_PAT_KEYを指定することで、主キーによる前方一致検索ができるようになります。
+
+.. groonga-command
+.. include:: ../example/tutorial08-1.log
+..
+   table_create --name PatPre --flags TABLE_PAT_KEY --key_type ShortText
+   load --table PatPre
+   [
+   {"_key":"ひろゆき"},
+   {"_key":"まろゆき"},
+   {"_key":"ひろあき"}
+   ]
+   select --table PatPre --query _key:@ひろ
+
+.. #主キーによる後方一致検索
+.. #------------------------
+.. #
+.. #table_createコマンドのflagsオプションにTABLE_PAT_KEYとKEY_WITH_SISを指定することで、主キーによる前方一致検索・後方一致検索の両方が可能となります。
+.. #
+.. #KEY_WITH_SISフラグを付与すると、データを追加する際に後方一致用のレコードまで追加されてしまいます。カラムに
+.. #
+.. #そのレコードとの区別をつけるためにflagカラムを追加しています。
+.. #
+.. #実行例 ::
+.. #
+.. # > table_create --name PatSuf --flags TABLE_PAT_KEY|KEY_WITH_SIS --key_type ShortText
+.. # [[0,1270635931.03862,0.00379]]
+.. # > column_create --table PatSuf --name original --type UInt8
+.. # [[0,1270635969.35514,0.013933]]
+.. # > load --table PatSuf
+.. # > [
+.. # > {"_key":"ひろゆき","original":1},
+.. # > {"_key":"まろゆき","original":1},
+.. # > {"_key":"ひろあき","original":1}
+.. # > ]
+.. # [[0,1270635973.61015,0.062957],3]
+.. # > select --table PatSuf --query _key:@ゆき
+.. # [[0,1270635977.04008,0.000461],[[[4],[["_id","UInt32"],["_key","ShortText"],["original","UInt8"]],[1,"ひろゆき",1],[5,"まろゆき",1],[3,"ゆき",0],[2,"ろゆき",0]]]]
+.. # > select --table PatSuf --query "_key:@ゆき + original:1"
+.. # [[0,1270636044.85414,0.000443],[[[2],[["_id","UInt32"],["_key","ShortText"],["original","UInt8"]],[1,"ひろゆき",1],[5,"まろゆき",1]]]]

data/vendor/local/share/groonga/doc/ja/source/tutorial/tutorial09.txt

@@ -0,0 +1,9 @@
+.. highlightlang:: none
+
+全文検索の語彙表に対する追加情報
+================================
+
+groongaでは、全文検索に用いるための語意表がテーブルとして扱えます。よって、語彙ごとに複数の情報を保持することができます。例えば、語彙の出現数や検索ストップワードのフラグ、単語の重要度などを保持することができます。
+
+この項目については、現在執筆中です。
+

data/vendor/local/share/groonga/doc/ja/source/tutorial/tutorial10.txt

@@ -0,0 +1,486 @@
+.. highlightlang:: none
+
+.. groonga-command
+.. table_remove Users
+.. table_remove Comments
+.. table_remove HashTags
+.. table_remove Bigram
+
+マイクロブログ検索システムの作成
+================================
+
+これまで学んだgroongaの機能を用いて、マイクロブログの検索システムを作成してみましょう。マイクロブログとは、Twitterのような短いメッセージを投稿するブログです。
+
+テーブルの作成
+--------------
+
+まずは、テーブルを作成します。
+
+::
+
+ table_create --name Users --flags TABLE_HASH_KEY --key_type ShortText
+ table_create --name Comments --flags TABLE_HASH_KEY --key_type ShortText
+ table_create --name HashTags --flags TABLE_HASH_KEY --key_type ShortText
+ table_create --name Bigram --flags TABLE_PAT_KEY|KEY_NORMALIZE --key_type ShortText --default_tokenizer TokenBigram
+
+ column_create --table Users --name name --flags COLUMN_SCALAR --type ShortText
+ column_create --table Users --name follower --flags COLUMN_VECTOR --type Users
+ column_create --table Users --name favorites --flags COLUMN_VECTOR --type Comments
+ column_create --table Users --name location --flags COLUMN_SCALAR --type WGS84GeoPoint
+ column_create --table Users --name location_str --flags COLUMN_SCALAR --type ShortText
+ column_create --table Users --name description --flags COLUMN_SCALAR --type ShortText
+ column_create --table Users --name folowee --flags COLUMN_INDEX --type Users --source follower
+
+ column_create --table Comments --name comment --flags COLUMN_SCALAR --type ShortText
+ column_create --table Comments --name last_modified --flags COLUMN_SCALAR --type Time
+ column_create --table Comments --name replied_to --flags COLUMN_SCALAR --type Comments
+ column_create --table Comments --name replied_users --flags COLUMN_VECTOR --type Users
+ column_create --table Comments --name hash_tags --flags COLUMN_VECTOR --type HashTags
+ column_create --table Comments --name location --flags COLUMN_SCALAR --type WGS84GeoPoint
+ column_create --table Comments --name posted_by --flags COLUMN_SCALAR --type Users
+ column_create --table Comments --name favorited_by --flags COLUMN_INDEX --type Users --source favorites
+
+ column_create --table HashTags --name hash_index --flags COLUMN_INDEX --type Comments --source hash_tags
+
+ column_create --table Bigram --name users_index --flags COLUMN_INDEX|WITH_POSITION|WITH_SECTION --type Users --source name,location_str,description
+ column_create --table Bigram --name comment_index --flags COLUMN_INDEX|WITH_POSITION --type Comments --source comment
+
+Usersテーブル
+^^^^^^^^^^^^^
+
+ユーザーの名前や自己紹介文、フォローしているユーザー一覧など、ユーザー情報を格納するためのテーブルです。
+
+``_key``
+  ユーザーID
+
+``name``
+  ユーザー名
+
+``follower``
+  フォローしているユーザーの一覧
+
+``favorites``
+  お気に入りのコメント一覧
+
+``location``
+  ユーザーの現在地（緯度経度座標）
+
+``location_str``
+  ユーザーの現在地（文字列）
+
+``description``
+  ユーザーの自己紹介
+
+``folowee``
+  Usersテーブルのfollowerカラムに対するインデックス。
+  このインデックスを作ることで、あるユーザーをフォローしているユーザーを検索できるようになります。
+
+Commentsテーブル
+^^^^^^^^^^^^^^^^
+
+コメント内容や投稿日時、返信先情報など、コメントに関する内容を格納するテーブルです。
+
+``_key``
+  コメントID
+
+``comment``
+  コメント内容
+
+``last_modified``
+  投稿日時
+
+``replied_to``
+  返信元のコメント内容
+
+``replied_users``
+  返信先のユーザーの一覧
+
+``hash_tags``
+  コメントのハッシュタグの一覧
+
+``location``
+  投稿場所(緯度経度座標のため)
+
+``posted_by``
+  コメントを書いたユーザー
+
+``favorited_by``
+  Usersテーブルのfavoritesカラムに対するインデックス。
+  このインデックスを作ることで、指定したコメントを誰がお気に入りに入れているのかを検索できるようになります。
+
+HashTagsテーブル
+^^^^^^^^^^^^^^^^
+
+コメントのハッシュタグを一覧で保存するためのテーブルです。
+
+``_key``
+  ハッシュタグ
+
+``hash_index``
+  「Comments.hash_tags」のインデックス。
+  このインデックスを作ることで、指定したハッシュタグのついているコメントの一覧を出すことが出来るようになります。
+
+Bigramテーブル
+^^^^^^^^^^^^^^
+
+ユーザー情報・コメントで全文検索が出来るようにするためのインデックスを格納するテーブルです。
+
+``_key``
+  単語
+
+``users_index``
+  ユーザー情報のインデックス。
+  このカラムは、ユーザー名「Users.name」、現在地「Users.location_str」、自己紹介文「Users.description」のインデックスになっています。
+
+``comment_index``
+  コメント内容「Comments.comment」のインデックス
+
+データのロード
+--------------
+
+つづいて、テスト用データをロードします。
+
+::
+
+ load --table Users
+ [
+   {
+     "_key": "daijiro",
+     "name": "hsiomaneki",
+     "follower": ["tasukuchan"],
+     "favorites": [],
+     "location": "127678039x502643091",
+     "location_str": "神奈川県",
+     "description": "groonga developer"
+   },
+   {
+     "_key": "tasukuchan",
+     "name": "グニャラくん",
+     "follower": ["daijiro","OffGao"],
+     "favorites": ["daijiro:1","OffGao:1"],
+     "location": "128423343x502929252",
+     "location_str": "東京都渋谷区",
+     "description": "エロいおっさん"
+   },
+   {
+     "_key": "OffGao",
+     "name": "OffGao",
+     "follower": ["tasukuchan","daijiro"],
+     "favorites": ["tasukuchan:1","daijiro:1"],
+     "location": "128544408x502801502",
+     "location_str": "東京都中野区",
+     "description": "がおがお"
+   }
+ ]
+
+ load --table Comments
+ [
+   {
+     "_key": "daijiro:1",
+     "comment": "マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。",
+     "last_modified": "2010/03/17 12:05:00",
+     "posted_by": "daijiro",
+   },
+   {
+     "_key": "tasukuchan:1",
+     "comment": "初の書き込み。テストテスト。",
+     "last_modified": "2010/03/17 12:00:00",
+     "posted_by": "tasukuchan",
+   },
+   {
+     "_key": "daijiro:2",
+     "comment": "@tasukuchan ようこそ!!!",
+     "last_modified": "2010/03/17 12:05:00",
+     "replied_to": "tasukuchan:1",
+     "replied_users": ["tasukuchan"],
+     "posted_by": "daijiro",
+   },
+   {
+     "_key": "tasukuchan:2",
+     "comment": "@daijiro ありがとう！",
+     "last_modified": "2010/03/17 13:00:00",
+     "replied_to": "daijiro:2",
+     "replied_users": ["daijiro"],
+     "posted_by": "tasukuchan",
+   },
+   {
+     "_key": "tasukuchan:3",
+     "comment": "groongaなう #groonga",
+     "last_modified": "2010/03/17 14:00:00",
+     "hash_tags": ["groonga"],
+     "location": "127972422x503117107",
+     "posted_by": "tasukuchan",
+   },
+   {
+     "_key": "tasukuchan:4",
+     "comment": "groonga開発合宿のため羽田空港に来ました！ #groonga #travel",
+     "last_modified": "2010/03/17 14:05:00",
+     "hash_tags": ["groonga", "travel"],
+     "location": "127975798x502919856",
+     "posted_by": "tasukuchan",
+   },
+   {
+     "_key": "OffGao:1",
+     "comment": "@daijiro @tasukuchan 登録してみましたよー！",
+     "last_modified": "2010/03/17 15:00:00",
+     "replied_users": ["daijiro", "tasukuchan"],
+     "location": "128551935x502796433",
+     "posted_by": "OffGao",
+   }
+   {
+     "_key": "OffGao:2",
+     "comment": "中野ブロードウェイなうなう",
+     "last_modified": "2010/03/17 15:05:00",
+     "location": "128551935x502796434",
+     "posted_by": "OffGao",
+   }
+ ]
+
+Usersテーブルのfollowerカラムとfavoritesカラム、そしてCommentsテーブルのreplied_usersカラムは、ベクターカラムです。そのため、これらのカラムは配列で値を指定します。
+
+Usersテーブルのlocationカラムと、Commentsテーブルのlocationカラムは、GeoPoint型です。この型での値の指定は、"[緯度]x[経度]"と記述して指定します。
+
+Commentsテーブルのlast_modifiedカラムは、Time型です。この型での値の指定方法は、マイクロ秒数の値を直接指定する方法のほかに、文字列で指定する方法もあります。"年/月/日 時:分:秒"というフォーマットで記述することで、データロードの際に文字列からキャストされ、マイクロ秒数の値が格納されます。
+
+.. groonga-command
+..
+ table_create --name Users --flags TABLE_HASH_KEY --key_type ShortText
+ table_create --name Comments --flags TABLE_HASH_KEY --key_type ShortText
+ table_create --name HashTags --flags TABLE_HASH_KEY --key_type ShortText
+ table_create --name Bigram --flags TABLE_PAT_KEY|KEY_NORMALIZE --key_type ShortText --default_tokenizer TokenBigram
+ 
+ column_create --table Users --name name --flags COLUMN_SCALAR --type ShortText
+ column_create --table Users --name follower --flags COLUMN_VECTOR --type Users
+ column_create --table Users --name favorites --flags COLUMN_VECTOR --type Comments
+ column_create --table Users --name location --flags COLUMN_SCALAR --type WGS84GeoPoint
+ column_create --table Users --name location_str --flags COLUMN_SCALAR --type ShortText
+ column_create --table Users --name description --flags COLUMN_SCALAR --type ShortText
+ column_create --table Users --name folowee --flags COLUMN_INDEX --type Users --source follower
+ 
+ column_create --table Comments --name comment --flags COLUMN_SCALAR --type ShortText
+ column_create --table Comments --name last_modified --flags COLUMN_SCALAR --type Time
+ column_create --table Comments --name replied_to --flags COLUMN_SCALAR --type Comments
+ column_create --table Comments --name replied_users --flags COLUMN_VECTOR --type Users
+ column_create --table Comments --name hash_tags --flags COLUMN_VECTOR --type HashTags
+ column_create --table Comments --name location --flags COLUMN_SCALAR --type WGS84GeoPoint
+ column_create --table Comments --name posted_by --flags COLUMN_SCALAR --type Users
+ column_create --table Comments --name favorited_by --flags COLUMN_INDEX --type Users --source favorites
+ 
+ column_create --table HashTags --name hash_index --flags COLUMN_INDEX --type Comments --source hash_tags
+ 
+ column_create --table Bigram --name users_index --flags COLUMN_INDEX|WITH_POSITION|WITH_SECTION --type Users --source name,location_str,description
+ column_create --table Bigram --name comment_index --flags COLUMN_INDEX|WITH_POSITION --type Comments --source comment
+ 
+ load --table Users
+ [
+   {
+     "_key": "daijiro",
+     "name": "hsiomaneki",
+     "follower": ["tasukuchan"],
+     "favorites": [],
+     "location": "127678039x502643091",
+     "location_str": "神奈川県",
+     "description": "groonga developer"
+   },
+   {
+     "_key": "tasukuchan",
+     "name": "グニャラくん",
+     "follower": ["daijiro","OffGao"],
+     "favorites": ["daijiro:1","OffGao:1"],
+     "location": "128423343x502929252",
+     "location_str": "東京都渋谷区",
+     "description": "エロいおっさん"
+   },
+   {
+     "_key": "OffGao",
+     "name": "OffGao",
+     "follower": ["tasukuchan","daijiro"],
+     "favorites": ["tasukuchan:1","daijiro:1"],
+     "location": "128544408x502801502",
+     "location_str": "東京都中野区",
+     "description": "がおがお"
+   }
+ ]
+ 
+ load --table Comments
+ [
+   {
+     "_key": "daijiro:1",
+     "comment": "マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。",
+     "last_modified": "2010/03/17 12:05:00",
+     "posted_by": "daijiro",
+   },
+   {
+     "_key": "tasukuchan:1",
+     "comment": "初の書き込み。テストテスト。",
+     "last_modified": "2010/03/17 12:00:00",
+     "posted_by": "tasukuchan",
+   },
+   {
+     "_key": "daijiro:2",
+     "comment": "@tasukuchan ようこそ!!!",
+     "last_modified": "2010/03/17 12:05:00",
+     "replied_to": "tasukuchan:1",
+     "replied_users": ["tasukuchan"],
+     "posted_by": "daijiro",
+   },
+   {
+     "_key": "tasukuchan:2",
+     "comment": "@daijiro ありがとう！",
+     "last_modified": "2010/03/17 13:00:00",
+     "replied_to": "daijiro:2",
+     "replied_users": ["daijiro"],
+     "posted_by": "tasukuchan",
+   },
+   {
+     "_key": "tasukuchan:3",
+     "comment": "groongaなう #groonga",
+     "last_modified": "2010/03/17 14:00:00",
+     "hash_tags": ["groonga"],
+     "location": "127972422x503117107",
+     "posted_by": "tasukuchan",
+   },
+   {
+     "_key": "tasukuchan:4",
+     "comment": "groonga開発合宿のため羽田空港に来ました！ #groonga #travel",
+     "last_modified": "2010/03/17 14:05:00",
+     "hash_tags": ["groonga", "travel"],
+     "location": "127975798x502919856",
+     "posted_by": "tasukuchan",
+   },
+   {
+     "_key": "OffGao:1",
+     "comment": "@daijiro @tasukuchan 登録してみましたよー！",
+     "last_modified": "2010/03/17 15:00:00",
+     "replied_users": ["daijiro", "tasukuchan"],
+     "location": "128551935x502796433",
+     "posted_by": "OffGao",
+   }
+   {
+     "_key": "OffGao:2",
+     "comment": "中野ブロードウェイなうなう",
+     "last_modified": "2010/03/17 15:05:00",
+     "location": "128551935x502796434",
+     "posted_by": "OffGao",
+   }
+ ]
+
+
+
+検索
+----
+
+それでは、実際に検索をしてみましょう。
+
+キーワードでユーザー検索
+^^^^^^^^^^^^^^^^^^^^^^^^
+ここでは、 :doc:`tutorial07` で扱った、複数カラムを対象とした検索を行います。
+指定された文字列で、ユーザー名・現在地・自己紹介文を対象に検索をします。
+
+.. groonga-command
+.. include:: ../example/tutorial10-1.log
+.. select --table Users --match_columns name,location_str,description --query 東京 --output_columns _key,name
+
+「東京」をキーワードにユーザー検索した結果、東京都に住んでいる「グニャラくん」と「OffGao」がヒットしました。
+
+GeoPointでユーザー検索
+^^^^^^^^^^^^^^^^^^^^^^
+
+ここでは、 :doc:`tutorial04` で扱った、GeoPoint型のカラムで検索をします。
+以下の例では、指定された位置から5000m以内にいるユーザーを検索しています。
+
+.. groonga-command
+.. include:: ../example/tutorial10-2.log
+.. select --table Users --filter 'geo_in_circle(location,"128484216x502919856",5000)' --output_columns _key,name
+
+新宿駅から5km以内にすんでいるユーザーを検索したところ、「グニャラくん」と「OffGao」がヒットしました。
+
+あるユーザーをフォローしているユーザーの検索
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+ここでは、 :doc:`tutorial06` で扱った、参照関係の逆引きをします。
+以下の例では、Usersテーブルのfollowerカラムにあるフォローリストを逆引きします。
+
+.. groonga-command
+.. include:: ../example/tutorial10-3.log
+.. select --table Users --query follower:@tasukuchan --output_columns _key,name
+
+「グニャラくん」をフォローしている「hsiomaneki」と「OffGao」がヒットしました。
+
+GeoPointでコメント検索
+^^^^^^^^^^^^^^^^^^^^^^
+ある範囲内で書かれたコメントを検索します。
+また、 :doc:`tutorial05` で扱ったドリルダウンも行います。検索結果をハッシュタグとユーザーでドリルダウンし、ユーザー別・ハッシュタグ別のカウントを出します。
+
+.. groonga-command
+.. include:: ../example/tutorial10-4.log
+.. select --table Comments --filter 'geo_in_circle(location,"127975798x502919856",20000)' --output_columns posted_by.name,comment --drilldown hash_tags,posted_by
+
+範囲を広く指定したため、位置情報のあるすべてのコメントがヒットしました。そして、ヒットしたコメントからドリルダウンされた結果も返ってきており、ハッシュタグは「#groonga」が2つに「#travel」が1つ、投稿者は「グニャラくん」「OffGao」がそれぞれ2件ずつであることがわかります。
+
+キーワードでコメント検索
+^^^^^^^^^^^^^^^^^^^^^^^^
+あるキーワードを含むコメントを検索します。
+さらに、 :doc:`tutorial04` で扱った、スコア値_scoreも出してみましょう。
+
+.. groonga-command
+.. include:: ../example/tutorial10-5.log
+.. select --table Comments --query comment:@なう --output_columns comment,_score
+
+「なう」をキーワードにコメント検索した結果、2件のコメントがヒットしました。また、_scoreの値も返ってきており、「なう」の数が出力されていることが確認できます。
+
+GeoPointとキーワードでコメント検索
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+今度は、キーワードとGeoPointの両方を条件に検索をしてみます。--queryと--filterの両方を使用した場合、両方の条件に一致するレコードがヒットします。
+
+.. groonga-command
+.. include:: ../example/tutorial10-6.log
+.. select --table Comments --query comment:@羽田 --filter 'geo_in_circle(location,"127975798x502919856",20000)' --output_columns posted_by.name,comment --drilldown hash_tags,posted_by
+
+両方の条件を満たすコメントが1件ヒットしました。また、ドリルダウンの結果も返ってきており、「グニャラくん」のコメント1件であることがわかります。
+
+ハッシュタグでコメント検索
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+あるハッシュタグのついているコメントを検索します。
+これも、 :doc:`tutorial06` で扱った、参照関係の逆引きを使います。
+
+.. groonga-command
+.. include:: ../example/tutorial10-7.log
+.. select --table Comments --query hash_tags:@groonga --output_columns posted_by.name,comment --drilldown posted_by
+
+#groongaタグの付いている2件のコメントがヒットしました。また、投稿者のドリルダウンも返ってきており、2件とも「グニャラくん」のものであることがわかります。
+
+ユーザーIDでコメント検索
+^^^^^^^^^^^^^^^^^^^^^^^^
+あるユーザーが投稿したコメントを検索します。
+
+.. groonga-command
+.. include:: ../example/tutorial10-8.log
+.. select --table Comments --query posted_by:tasukuchan --output_columns comment --drilldown hash_tags
+
+「グニャラくん」が書き込んだ4件のコメントがヒットしました。また、ハッシュタグでドリルダウンした結果も返ってきており、ハッシュタグは「#groonga」が2つに「#travel」が1つあることがわかります。
+
+ユーザーのお気に入りコメントを検索
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+あるユーザーがお気に入りに入れているコメントを検索します。
+
+.. groonga-command
+.. include:: ../example/tutorial10-9.log
+.. select --table Users --query _key:tasukuchan --output_columns favorites.posted_by,favorites.comment
+
+「グニャラくん」がお気に入りに入れている2件のコメントがヒットしました。
+
+投稿時間でコメント検索
+^^^^^^^^^^^^^^^^^^^^^^
+コメントの投稿時間で検索をします。Time型については :doc:`tutorial03` で扱っています。
+この例では、指定した時間よりも前に投稿されているコメントを検索します。
+
+.. groonga-command
+.. include:: ../example/tutorial10-10.log
+.. select Comments --filter 'last_modified<=1268802000' --output_columns posted_by.name,comment,last_modified --drilldown hash_tags,posted_by
+
+2010/03/17 14:00:00以前に書かれたコメント5件がヒットしました。また、ドリルダウンの結果も返ってきており、「hsiomaneki」が2件、「グニャラくん」が3件ヒットしていることがわかります。
+
+.. TODO: 以下の機能はgroonga本体での支援が必要。
+.. タイムライン表示: あるユーザがfollowしているユーザの発言を、時系列順の逆順で並べて10件のみ表示。
+.. 複数の条件での検索: favoriteの数がn以上の発言で全文検索、さらにユーザでドリルダウン