rroonga 1.2.7-x86-mingw32 → 1.3.0-x86-mingw32

data/vendor/local/share/doc/groonga/source/tutorial/query_expansion.txt

@@ -0,0 +1,57 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+クエリ拡張
+==========
+
+groongaでは、 :doc:`/commands/select` コマンドにquery_expansionパラメータを指定することによって、ユーザが指定した検索文字列を適宜拡張することが可能です。
+
+たとえば、ユーザが'シークヮーサー'という文字列で検索した場合に、'シークヮーサー OR シークァーサー'で検索した場合と同一の結果を返すことによって、本来ユーザが必要とする結果をよりもれなく検索できるようになります。
+
+準備
+----
+
+クエリ拡張機能を使用するためには、検索対象となる文書を格納するテーブル(ここでは文書テーブルと呼びます)以外に、ユーザの指定した検索文字列を置換するためのテーブル(ここでは置換テーブルと呼びます)を準備します。置換テーブルでは、その主キーが置換前の文字列となり、文字列型(ShortText)のカラムの値が置換後の文字列となります。
+
+実際に文書テーブルと置換テーブルを作成してみましょう。
+
+.. groonga-command
+.. include:: ../example/tutorial/query_expansion-1.log
+.. table_create Doc TABLE_PAT_KEY ShortText
+.. column_create Doc body COLUMN_SCALAR ShortText
+.. table_create Term TABLE_PAT_KEY|KEY_NORMALIZE ShortText --default_tokenizer TokenBigram
+.. column_create Term Doc_body COLUMN_INDEX|WITH_POSITION Doc body
+.. table_create Synonym TABLE_PAT_KEY ShortText
+.. column_create Synonym body COLUMN_SCALAR ShortText
+.. load --table Doc
+.. [
+.. {"_key": "001", "body": "すっぱいブドウと甘いシークァーサー"},
+.. {"_key": "002", "body": "シークヮーサージュースとゴーヤチャンプル"},
+.. ]
+.. load --table Synonym
+.. [
+.. {"_key": "シークァーサー", "body": "(シークァーサー OR シークヮーサー)"},
+.. {"_key": "シークヮーサー", "body": "(シークァーサー OR シークヮーサー)"},
+.. ]
+
+この例では、ユーザが"シークァーサー"と入力しても、"シークヮーサー"と入力しても、それぞれの異なる表記の文書をもれなく検索するための置換テーブルを作成しています。
+
+検索
+----
+
+それでは実際に、準備した置換テーブルを使ってみましょう。まずは、query_expansionパラメータを指定せずにselectコマンドを使って検索してみます。
+
+.. groonga-command
+.. include:: ../example/tutorial/query_expansion-2.log
+.. select Doc --match_columns body --query "シークァーサー"
+.. select Doc --match_columns body --query "シークヮーサー"
+
+指定された文字列に完全に一致するレコードのみがそれぞれヒットします。次に、query_expansionパラメータに、準備したSynonymテーブルのbodyカラムを指定してみましょう。
+
+.. groonga-command
+.. include:: ../example/tutorial/query_expansion-3.log
+.. select Doc --match_columns body --query "シークァーサー" --query_expansion Synonym.body
+.. select Doc --match_columns body --query "シークヮーサー" --query_expansion Synonym.body
+
+どちらのクエリ文字列も、"(シークァーサー OR シークヮーサー)"という文字列に置換されてから検索されるため、表記の揺れを吸収して検索できるようになりました。

data/vendor/local/share/doc/groonga/{ja/html/_sources/tutorial/tutorial04.txt → source/tutorial/search.txt}

@@ -2,7 +2,7 @@
 
 .. highlightlang:: none
 
-.. groonga-include : tutorial03.txt
+.. groonga-include : data.txt
 
 さまざまな検索条件の指定
 ========================
@@ -15,7 +15,7 @@ JavaScriptに似た文法での絞込・全文検索
 selectコマンドのfilterパラメータは、queryパラメータと同様に、レコードの検索条件を指定します。filterパラメータとqueryパラメータが異なる点は、filterパラメータには、JavaScriptの式に似た文法で条件を指定する点です。
 
 .. groonga-command
-.. include:: ../example/tutorial04-1.log
+.. include:: ../example/tutorial/search-1.log
 .. select --table Site --filter "_id <= 1" --output_columns _id,_key
 
 ここで、filterパラメータには
@@ -27,7 +27,7 @@ selectコマンドのfilterパラメータは、queryパラメータと同様に
 また、&& や || を使って、条件のAND・OR指定をすることもできます。
 
 .. groonga-command
-.. include:: ../example/tutorial04-2.log
+.. include:: ../example/tutorial/search-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
 
@@ -43,7 +43,7 @@ filterパラメータと同様に、
 JavaScriptの式に似たな文法で様々な条件を指定することができます。
 
 .. groonga-command
-.. include:: ../example/tutorial04-3.log
+.. include:: ../example/tutorial/search-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
 
@@ -70,12 +70,17 @@ groongaでは、位置情報（経緯度）を保存することができます
 
 位置情報を保存するためのカラムの型として、TokyoGeoPoint/WGS84GeoPointの２つの型があります。前者は日本測地系、後者は世界測地系(WGS84相当)の経緯度を保存します。
 
-経緯度をデータを入力するためには、"緯度のミリ秒x経度のミリ秒"という形式の文字列を代入する必要があります。
+経緯度は以下のいずれかの形式の文字列として指定します。
 
-ここでは、ためしに東京駅と新宿駅とついて、世界測地系での位置情報を保存してみましょう。東京駅は緯度が35度40分52.975秒、経度が139度45分57.902秒です。新宿駅は緯度が35度41分27.316秒、経度が139度42分0.929秒です。よって、代入する文字列はそれぞれ"128452975x503157902"/"128487316x502920929"となります。
+* "[緯度のミリ秒]x[経度のミリ秒]"（例: "128452975x503157902"）
+* "[緯度のミリ秒],[経度のミリ秒]"（例: "128452975,503157902"）
+* "[緯度の小数表記の度数]x[経度の小数表記の度数]"（例: "35.6813819x139.7660839"）
+* "[緯度の小数表記の度数],[経度の小数表記の度数]"（例: "35.6813819,139.7660839"）
+
+ここでは、ためしに東京駅と新宿駅とついて、世界測地系での位置情報を保存してみましょう。東京駅は緯度が35度40分52.975秒、経度が139度45分57.902秒です。新宿駅は緯度が35度41分27.316秒、経度が139度42分0.929秒です。よって、ミリ秒表記の場合はそれぞれ"128452975x503157902"/"128487316x502920929"となります。度数表記の場合はそれぞれ"35.6813819x139.7660839"/"35.6909211x139.7002581"となります。ここではミリ秒表記で登録しましょう。
 
 .. groonga-command
-.. include:: ../example/tutorial04-4.log
+.. include:: ../example/tutorial/search-4.log
 .. column_create --table Site --name location --type WGS84GeoPoint
 .. load --table Site
 .. [
@@ -84,12 +89,12 @@ groongaでは、位置情報（経緯度）を保存することができます
 .. ]
 .. select --table Site --query "_id:1 OR _id:2" --output_columns _key,location
 
-scorerパラメータにおいて、 :doc:`../functions/geo_distance` 関数を用いることにより、２点間の距離を計算することができます。
+scorerパラメータにおいて、 :doc:`/functions/geo_distance` 関数を用いることにより、２点間の距離を計算することができます。
 
 ここでは、秋葉原駅からの距離を表示させてみましょう。世界測地系では、秋葉原駅の位置は緯度が35度41分55.259秒、経度が139度46分27.188秒です。よって、geo_distance関数に与える文字列は"128515259x503187188"となります。
 
 .. groonga-command
-.. include:: ../example/tutorial04-5.log
+.. include:: ../example/tutorial/search-5.log
 .. select --table Site --query "_id:1 OR _id:2" --output_columns _key,location,_score --scorer '_score = geo_distance(location, "128515259x503187188")'
 
 この結果を見ると、東京駅と秋葉原駅は2054m、秋葉原駅と新宿駅は6720m離れているようです。
@@ -97,17 +102,17 @@ scorerパラメータにおいて、 :doc:`../functions/geo_distance` 関数を
 geo_distance関数は、_scoreを通じてソートでも用いることができます。
 
 .. groonga-command
-.. include:: ../example/tutorial04-6.log
+.. include:: ../example/tutorial/search-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以下におさまるかどうかを判定することができます。
+filterパラメータにおいて、 :doc:`/functions/geo_in_circle` 関数を用いることにより、２点間の距離が指定のm以下におさまるかどうかを判定することができます。
 
 たとえば、秋葉原駅から5000m以内にあるレコードを検索してみましょう。
 
 .. groonga-command
-.. include:: ../example/tutorial04-7.log
+.. include:: ../example/tutorial/search-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/doc/groonga/source/tutorial.txt

@@ -7,6 +7,15 @@
 
 .. toctree::
    :maxdepth: 2
-   :glob:
 
-   tutorial/*
+   tutorial/introduction
+   tutorial/network
+   tutorial/data
+   tutorial/search
+   tutorial/drilldown
+   tutorial/index
+   tutorial/match_columns
+   tutorial/patricia_trie
+   tutorial/lexicon
+   tutorial/micro_blog
+   tutorial/query_expansion