rroonga 2.1.2-x86-mingw32 → 2.1.3-x86-mingw32

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

@@ -1,62 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-.. groonga-command
-.. database: tutorial-query-expansion
-
-クエリ拡張
-==========
-
-groongaでは、 :doc:`/reference/commands/select` コマンドにquery_expansionパラメータを指定することによって、ユーザが指定した検索文字列を適宜拡張することが可能です。
-
-たとえば、ユーザが'シークヮーサー'という文字列で検索した場合に、'シークヮーサー OR シークァーサー'で検索した場合と同一の結果を返すことによって、本来ユーザが必要とする結果をよりもれなく検索できるようになります。
-
-準備
-----
-
-クエリ拡張機能を使用するためには、検索対象となる文書を格納するテーブル(ここでは文書テーブルと呼びます)以外に、ユーザの指定した検索文字列を置換するためのテーブル(ここでは置換テーブルと呼びます)を準備します。置換テーブルでは、その主キーが置換前の文字列となり、文字列型(ShortText)のカラムの値が置換後の文字列となります。
-
-TODO: 文字列型のベクターカラムでも可能であり、その場合は各要素をORでつなげたものに置換されるということを記述する。
-
-実際に文書テーブルと置換テーブルを作成してみましょう。
-
-.. 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/source/tutorial/search.txt

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

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

@@ -1,21 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-Tutorial
-========
-
-.. toctree::
-   :maxdepth: 2
-
-   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