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

data/vendor/local/share/doc/groonga/source/troubleshooting/different_results_with_the_same_keyword.txt

@@ -1,135 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-同じ検索キーワードなのに全文検索結果が異なる
-============================================
-
-同じ検索キーワードでも一緒に指定するクエリによっては全文検索の結果が異なることがあります。ここでは、その原因と対策方法を説明します。
-
-例
---
-
-まず、実際に検索結果が異なる例を説明します。
-
-DDLは以下の通りです。BlogsテーブルのbodyカラムをTokenMecabトークナイザーを使ってトークナイズしてからインデックスを作成しています。::
-
-  table_create Blogs TABLE_NO_KEY
-  column_create Blogs body COLUMN_SCALAR ShortText
-  column_create Blogs updated_at COLUMN_SCALAR Time
-  table_create Terms TABLE_PAT_KEY|KEY_NORMALIZE ShortText --default_tokenizer TokenMecab
-  column_create Terms blog_body COLUMN_INDEX|WITH_POSITION Blogs body
-
-テスト用のデータは1件だけ投入します。::
-
-  load --table Blogs
-  [
-    ["body", "updated_at"],
-    ["東京都民に深刻なダメージを与えました。", "2010/9/21 10:18:34"],
-  ]
-
-まず、全文検索のみで検索します。この場合ヒットします。::
-
-  > select Blogs --filter 'body @ "東京都"'
-  [[0,4102.268052438,0.000743783],[[[1],[["_id","UInt32"],["updated_at","Time"],["body","ShortText"]],[1,1285031914.0,"東京都民に深刻なダメージを与えました。"]]]]
-
-続いて、範囲指定と全文検索を組み合わせて検索します（1285858800は2010/10/1 0:0:0の秒表記）。この場合もヒットします。::
-
-  > select Blogs --filter 'body @ "東京都" && updated_at < 1285858800'
-  [[0,4387.524084839,0.001525487],[[[1],[["_id","UInt32"],["updated_at","Time"],["body","ShortText"]],[1,1285031914.0,"東京都民に深刻なダメージを与えました。"]]]]
-
-最後に、範囲指定と全文検索の順番を入れ替えて検索します。個々の条件は同じですが、この場合はヒットしません。::
-
-  > select Blogs --filter 'updated_at < 1285858800 && body @ "東京都"'
-  [[0,4400.292570838,0.000647716],[[[0],[["_id","UInt32"],["updated_at","Time"],["body","ShortText"]]]]]
-
-どうしてこのような挙動になるかを説明します。
-
-原因
-----
-
-このような挙動になるのは全文検索時に複数の検索の挙動を使い分けているからです。ここでは簡単に説明するので、詳細は :doc:`/spec/search` を参照してください。
-
-検索の挙動には以下の3種類があります。
-
-1. 完全一致検索
-2. 非わかち書き検索
-3. 部分一致検索
-
-groongaは基本的に完全一致検索のみを行います。上記の例では「東京都民に深刻なダメージを与えました。」を「東京都」というクエリで検索していますが、TokenMecabトークナイザーを使っている場合はこのクエリはマッチしません。
-
-検索対象の「東京都民に深刻なダメージを与えました。」は
-
-  東京 / 都民 / に / 深刻 / な / ダメージ / を / 与え / まし / た / 。
-
-とトークナイズされますが、クエリの「東京都」は
-
-  東京 / 都
-
-とトークナイズされるため、完全一致しません。
-
-groongaは完全一致検索した結果のヒット件数が所定の閾値を超えない場合に限り、非わかち書き検索を行い、それでもヒット件数が閾値を超えない場合は部分一致検索を行います（閾値は1がデフォルト値となっています）。このケースのデータは部分一致検索ではヒットするので、「東京都」クエリのみを指定するとヒットします。
-
-しかし、以下のように全文検索前にすでに閾値が越えている場合（「updated_at < 1285858800」で1件ヒットし、閾値を越える）は、たとえ完全一致検索で1件もヒットしない場合でも部分一致検索などを行いません。::
-
-  select Blogs --filter 'updated_at < 1285858800 && body @ "東京都"'
-
-そのため、条件の順序を変えると検索結果が変わるという状況が発生します。以下で、この情報を回避する方法を2種類紹介しますが、それぞれトレードオフとなる条件があるので採用するかどうかを十分検討してください。
-
-対策方法1: トークナイザーを変更する
------------------------------------
-
-TokenMecabトークナイザーは事前に準備した辞書を用いてトークナイズするため、再現率よりも適合率を重視したトークナイザーと言えます。一方、TokenBigramなど、N-gram系のトークナイザーは適合率を重視したトークナイザーと言えます。例えば、TokenMecabの場合「東京都」で「京都」に完全一致することはありませんが、TokenBigramでは完全一致します。一方、TokenMecabでは「東京都民」に完全一致しませんが、TokenBigramでは完全一致します。
-
-このようにN-gram系のトークナイザーを指定することにより再現率をあげることができますが、適合率が下がり検索ノイズが含まれる可能性が高くなります。この度合いを調整するためには :doc:`/reference/commands/select` のmatch_columnsで使用する索引毎に重み付けを指定します。
-
-ここでも、前述の例を使って具体例を示します。まず、TokenBigramを用いた索引を追加します。::
-
-  table_create Bigram TABLE_PAT_KEY|KEY_NORMALIZE ShortText --default_tokenizer TokenBigram
-  column_create Bigram blog_body COLUMN_INDEX|WITH_POSITION Blogs body
-
-この状態でも以前はマッチしなかったレコードがヒットするようになります。::
-
-  > select Blogs --filter 'updated_at < 1285858800 && body @ "東京都"'
-  [[0,7163.448064902,0.000418127],[[[1],[["_id","UInt32"],["updated_at","Time"],["body","ShortText"]],[1,1285031914.0,"東京都民に深刻なダメージを与えました。"]]]]
-
-しかし、N-gram系のトークナイザーの方がTokenMecabトークナイザーよりも語のヒット数が多いため、N-gram系のヒットスコアの方が重く扱われてしまいます。N-gram系のトークナイザーの方がTokenMecabトークナイザーよりも適合率の低い場合が多いので、このままでは検索ノイズが上位に表示される可能性が高くなります。
-
-そこで、TokenMecabトークナイザーを使って作った索引の方をTokenBigramトークナイザーを使って作った索引よりも重視するように重み付けを指定します。これは、match_columnsオプションで指定できます。::
-
-  > select Blogs --match_columns 'Terms.blog_body * 10 || Bigram.blog_body * 3' --query '東京都' --output_columns '_score, body'
-  [[0,8167.364602632,0.000647003],[[[1],[["_score","Int32"],["body","ShortText"]],[13,"東京都民に深刻なダメージを与えました。"]]]]
-
-この場合はスコアが11になっています。内訳は、Terms.blog_body索引（TokenMecabトークナイザーを使用）でマッチしたので10、Bigram.blog_body索引（TokenBigramトークナイザーを使用）でマッチしたので3、これらを合計して13になっています。このようにTokenMecabトークナイザーの重みを高くすることにより、検索ノイズが上位にくることを抑えつつ再現率を上げることができます。
-
-この例は日本語だったのでTokenBigramトークナイザーでよかったのですが、アルファベットの場合はTokenBigramSplitSymbolAlphaトークナイザーなども利用する必要があります。例えば、「楽しいbilliard」はTokenBigramトークナイザーでは
-
-  楽し / しい / billiard
-
-となり、「bill」では完全一致しません。一方、TokenBigramSplitSymbolAlphaトークナイザーを使うと
-
-  楽し / しい / いb / bi / il / ll / li / ia / ar / rd / d
-
-となり、「bill」でも完全一致します。
-
-TokenBigramSplitSymbolAlphaトークナイザーを使う場合も重み付けを考慮する必要があることはかわりありません。
-
-利用できるバイグラム系のトークナイザーの一覧は以下の通りです。
-
-* TokenBigram: バイグラムでトークナイズする。連続する記号・アルファベット・数字は一語として扱う。
-* TokenBigramSplitSymbol: 記号もバイグラムでトークナイズする。連続するアルファベット・数字は一語として扱う。
-* TokenBigramSplitSymbolAlpha: 記号とアルファベットもバイグラムでトークナイズする。連続する数字は一語として扱う。
-* TokenBigramSplitSymbolAlphaDigit: 記号・アルファベット・数字もバイグラムでトークナイズする。
-* TokenBigramIgnoreBlank: バイグラムでトークナイズする。連続する記号・アルファベット・数字は一語として扱う。空白は無視する。
-* TokenBigramIgnoreBlankSplitSymbol: 記号もバイグラムでトークナイズする。連続するアルファベット・数字は一語として扱う。空白は無視する。
-* TokenBigramIgnoreBlankSplitSymbolAlpha: 記号とアルファベットもバイグラムでトークナイズする。連続する数字は一語として扱う。空白は無視する。
-* TokenBigramIgnoreBlankSplitSymbolAlphaDigit: 記号・アルファベット・数字もバイグラムでトークナイズする。空白は無視する。
-
-対策方法2: 閾値をあげる
------------------------
-
-非わかち書き検索・部分一致検索を利用するかどうかの閾値は--with-match-escalation-threshold configureオプションで変更することができます。以下のように指定すると、100件以下のヒット数であれば、たとえ完全一致検索でヒットしても、非わかち書き検索・部分一致検索を行います。::
-
-  % ./configure --with-match-escalation-threashold=100
-
-この場合も対策方法1同様、検索ノイズが上位に現れる可能性が高くなることに注意してください。検索ノイズが多くなった場合は指定する値を低くする必要があります。

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

@@ -1,12 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-トラブルシューティング
-======================
-
-.. toctree::
-   :maxdepth: 2
-   :glob:
-
-   troubleshooting/*

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

@@ -1,155 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-.. groonga-include : introduction.txt
-
-.. groonga-command
-.. database: tutorial
-
-Various data types
-==================
-
-Groonga is a full text search engine but also serves as a column-oriented data store. Groonga supports various data types, such as numeric types, string types, date and time type, longitude and latitude types, etc. This tutorial shows a list of data types and explains how to use them.
-
-Overview
---------
-
-The basic data types of groonga are roughly divided into 5 groups --- boolean type, numeric types, string types, date/time type and longitude/latitude types. The numeric types are further divided according to whether integer or floating point number, signed or unsigned and the number of bits allocated to each integer. The string types are further divided according to the maximum length. The longitude/latitude types are further divided according to the geographic coordinate system. For more details, see :doc:`/reference/types`.
-
-In addition, groonga supports reference types and vector types. Reference types are designed for accessing other tables. Vector types are designed for storing a variable number of values in one element.
-
-First, let's create a table for this tutorial.
-
-.. groonga-command
-.. include:: ../example/tutorial/data-1.log
-.. table_create --name ToyBox --flags TABLE_HASH_KEY --key_type ShortText
-
-Boolean type
-------------
-
-The boolean type is used to store true or false. To create a boolean type column, specify Bool to the `type` parameter of :doc:`/reference/commands/column_create` command. The default value of the boolean type is false.
-
-The following example creates a boolean type column and adds three records. Note that the third record has the default value because no value is specified.
-
-.. groonga-command
-.. include:: ../example/tutorial/data-2.log
-.. column_create --table ToyBox --name is_animal --type Bool
-.. load --table ToyBox
-.. [
-.. {"_key":"Monkey","is_animal":true}
-.. {"_key":"Flower","is_animal":false}
-.. {"_key":"Block"}
-.. ]
-.. select --table ToyBox --output_columns _key,is_animal
-
-Numeric types
--------------
-
-The numeric types are divided into integer types and a floating point number type. The integer types are further divided into the signed integer types and unsigned integer types. In addition, you can choose the number of bits allocated to each integer. For more details, see :doc:`/reference/types`. The default value of the numeric types is 0.
-
-The following example creates an Int8 column and a Float column, and then updates existing records. The :doc:`/reference/commands/load` command updates the weight column as expected. On the other hand, the price column values are different from the specified values because 15.9 is not an integer and 200 is too large. 15.9 is converted to 15 by removing the fractional part. 200 causes an overflow and the result becomes -56. Note that the result of an overflow/underflow is undefined.
-
-.. groonga-command
-.. include:: ../example/tutorial/data-3.log
-.. column_create --table ToyBox --name price --type Int8
-.. column_create --table ToyBox --name weight --type Float
-.. load --table ToyBox
-.. [
-.. {"_key":"Monkey","price":15.9}
-.. {"_key":"Flower","price":200,"weight":0.13}
-.. {"_key":"Block","weight":25.7}
-.. ]
-.. select --table ToyBox --output_columns _key,price,weight
-
-String types
-------------
-
-The string types are divided according to the maximum length. For more details, see :doc:`/reference/types`. The default value is the zero-length string.
-
-The following example creates a ShortText column and updates existing records. The third record has the default value because not updated.
-
-.. groonga-command
-.. include:: ../example/tutorial/data-4.log
-.. column_create --table ToyBox --name name --type ShortText
-.. load --table ToyBox
-.. [
-.. {"_key":"Monkey","name":"Grease"}
-.. {"_key":"Flower","name":"Rose"}
-.. ]
-.. select --table ToyBox --output_columns _key,name
-
-Date and time type
-------------------
-
-The date and time type of groonga is Time. Actually, a Time column stores a date and time as the number of microseconds since the Epoch, 1970-01-01 00:00:00. A Time value can represent a date and time before the Epoch because the actual data type is a signed integer. Note that :doc:`/reference/commands/load` and :doc:`/reference/commands/select` commands use a decimal number to represent a data and time in seconds. The default value is 0.0, which means the Epoch.
-
-The following example creates a Time column and updates existing records. The first record has the default value because not updated.
-
-.. groonga-command
-.. include:: ../example/tutorial/data-5.log
-.. column_create --table ToyBox --name time --type Time
-.. load --table ToyBox
-.. [
-.. {"_key":"Flower","time":1234567890.1234569999}
-.. {"_key":"Block","time":-1234567890}
-.. ]
-.. select --table ToyBox --output_columns _key,time
-
-Longitude and latitude types
-----------------------------
-
-The longitude and latitude types are divided according to the geographic coordinate system. For more details, see :doc:`/reference/types`. To represent a longitude and latitude, groonga uses a string formatted as follows:
-
-* "longitude x latitude" in milliseconds (e.g.: "128452975x503157902")
-* "longitude x latitude" in degrees (e.g.: "35.6813819x139.7660839")
-
-A number with/without a decimal point represents a longitude or latitude in milliseconds/degrees respectively. Note that a combination of a number with a decimal point and a number without a decimal point (e.g. 35.1x139) must not be used. A comma (',') is also available as a delimiter. The default value is "0x0".
-
-The following example creates a WGS84GeoPoint column and updates existing records. The second record has the default value because not updated.
-
-.. groonga-command
-.. include:: ../example/tutorial/data-6.log
-.. column_create --table ToyBox --name location --type WGS84GeoPoint
-.. load --table ToyBox
-.. [
-.. {"_key":"Monkey","location":"128452975x503157902"}
-.. {"_key":"Block","location":"35.6813819x139.7660839"}
-.. ]
-.. select --table ToyBox --output_columns _key,location
-
-Reference types
----------------
-
-Groonga supports a reference column, which stores references to records in its associated table. In practice, a reference column stores the IDs of the referred records in the associated table and enables access to those records.
-
-You can specify a column in the associated table to the `output_columns` parameter of a :doc:`/reference/commands/select` command. The format is "Src.Dest" where Src is the name of the reference column and Dest is the name of the target column. If only the reference column is specified, it is handled as "Src._key". Note that if a reference does not point to a valid record, a :doc:`/reference/commands/select` command outputs the default value of the target column.
-
-The following example adds a reference column to the Site table that was created in the previous tutorial. The new column, named link, is designed for storing links among records in the Site table.
-
-.. groonga-command
-.. include:: ../example/tutorial/data-7.log
-.. column_create --table Site --name link --type Site
-.. load --table Site
-.. [{"_key":"http://example.org/","link":"http://example.net/"}]
-.. select --table Site --output_columns _key,title,link._key,link.title --query title:@this
-
-The `type` parameter of the :doc:`/reference/commands/column_create` command specifies the table to be associated with the reference column. In this example, the reference column is associated with the own table. Then, the :doc:`/reference/commands/load` command registers a link from "http://example.org" to "http://example.net". Note that a reference column requires the primary key, not the ID, of the record to be referred to. After that, the link is confirmed by the :doc:`/reference/commands/select` command. In this case, the primary key and the title of the referred record are output because link._key and link.title are specified to the `output_columns` parameter.
-
-Vector types
-------------
-
-Groonga supports a vector column, in which each element can store a variable number of values. To create a vector column, specify the COLUMN_VECTOR flag to the `flags` parameter of a :doc:`/reference/commands/column_create` command. A vector column is useful to represent a many-to-many relationship.
-
-The previous example used a regular column, so each record could have at most one link. Obviously, the specification is insufficient because a site usually has more than one links. To solve this problem, the following example uses a vector column.
-
-.. FIXME: _idの配列ではダメなのかどうか。検証する。
-
-.. groonga-command
-.. include:: ../example/tutorial/data-8.log
-.. column_create --table Site --name links --flags COLUMN_VECTOR --type Site
-.. load --table Site
-.. [{"_key":"http://example.org/","links":["http://example.net/","http://example.org/","http://example.com/"]}]
-.. select --table Site --output_columns _key,title,links._key,links.title --query title:@this
-
-The only difference at the first step is the `flags` parameter that specifies to create a vector column. The `type` parameter of the :doc:`/reference/commands/column_create` command is the same as in the previous example. Then, the :doc:`/reference/commands/load` command registers three links from "http://example.org/" to "http://example.net/", "http://example.org/" and "http://example.com/". After that, the links are confirmed by the :doc:`/reference/commands/select` command. In this case, the primary keys and the titles are output as arrays because links._key and links.title are specified to the `output_columns` parameter.

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

@@ -1,66 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-.. groonga-include : search.txt
-
-.. groonga-command
-.. database: tutorial
-
-ドリルダウン
-============
-
-groongaでは、特定のカラム値で検索結果をグループ化することができます。これをドリルダウンと呼びます。
-
-Siteテーブルに２つのカラムを追加します。TLDドメイン名を格納するdomainカラムと、国名を格納するcountryカラムです。これらのカラムの型は、それぞれドメイン名を主キーとするSiteDomainテーブルと、国名を主キーとするSiteCountryテーブルとします。
-
-.. groonga-command
-.. include:: ../example/tutorial/drilldown-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/tutorial/drilldown-2.log
-.. select --table Site --limit 0 --drilldown domain
-
-テーブル型を持つカラムに対してドリルダウンを行った場合、参照先のテーブルに存在するカラム値を取得することもできます。ドリルダウンを行ったテーブルには、_nsubrecsという仮想的なカラムが追加されます。このカラムには、グループ化されたレコード数が入ります。
-
-.. groonga-command
-.. include:: ../example/tutorial/drilldown-3.log
-.. select --table Site --limit 0 --drilldown domain --drilldown_output_columns _id,_key,_nsubrecs
-
-複数のカラムに対してドリルダウンを行うことができます。複数のカラムに対してドリルダウンを行う場合には、drilldownパラメータにカラム名をカンマ区切りで与えます。
-
-.. groonga-command
-.. include:: ../example/tutorial/drilldown-4.log
-.. select --table Site --limit 0 --drilldown domain,country
-
-ドリルダウン結果を並びかえることができます。例えば、_nsubrecsパラメータの降順で並び替えることができます。
-
-.. groonga-command
-.. include:: ../example/tutorial/drilldown-5.log
-.. select --table Site --limit 0 --drilldown country --drilldown_sortby _nsubrecs
-
-ドリルダウン結果は、デフォルトでは10件のみ表示されます。drilldown_offsetパラメータと、drilldown_limitパラメータによって、offsetとlimitを指定することができます。
-
-.. groonga-command
-.. include:: ../example/tutorial/drilldown-6.log
-.. select --table Site --limit 0 --drilldown country --drilldown_sortby _nsubrecs --drilldown_limit 2 --drilldown_offset 2
-
-文字列型のカラムに対するドリルダウンは、他の型でのドリルダウンに比べて低速です。文字列でのドリルダウンを行いたい場合には、このチュートリアルのように、文字列型を主キーとするテーブルを別途作成し、そのテーブルを型とするカラムを作成します。

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

@@ -1,118 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-.. groonga-include : drilldown.txt
-
-.. groonga-command
-.. database: tutorial
-
-タグ検索・参照関係の逆引き
-==========================
-
-本チュートリアルで、groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。
-
-タグ検索はgroongaの転置インデックスというデータ構造を用いて高速に行われます。
-
-タグ検索
---------
-
-動画共有サイトの検索エンジンを作ることを想定します。1つの動画には、その動画の特徴を表す、複数の語句が付与されています。「ある語句が付与されている動画の一覧を取得する」検索を行いたいとします。
-
-実際に、動画情報のテーブルを作成し、検索をしてみましょう。
-
-動画の情報を保存する、Videoテーブルを作成します。Videoテーブルでは、動画のタイトルをtitleカラムに、動画のタグ情報をtagsカラムにTagテーブル型で複数格納しています。
-タグの情報を保存する、Tagテーブルを作成します。Tagテーブルでは、タグ文字列を主キーに格納し、Videoテーブルのtagsカラムに対するインデックスをindex_tagsカラムに格納しています。
-
-.. groonga-command
-.. include:: ../example/tutorial/index-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/tutorial/index-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/tutorial/index-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/tutorial/index-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/tutorial/index-5.log
-.. select --table User --limit 0 --drilldown friends
-
-このように、テーブルの参照関係を逆にたどる検索ができました。
-
-インデックス付きジオサーチ
---------------------------
-
-位置情報のカラムに対して、インデックスを付与することが出来ます。大量の位置情報レコードを検索する場合に、検索速度が速くなります。
-
-.. groonga-command
-.. include:: ../example/tutorial/index-6.log
-.. 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
-
-同様に、位置情報レコードを用いてソートする場合に、ソート速度が速くなります。
-
-.. groonga-command
-.. include:: ../example/tutorial/index-7.log
-.. select --table Site --filter 'geo_in_circle(location, "128515259x503187188", 50000)' --output_columns _key,location,_score --sortby '-geo_distance(location, "128515259x503187188")' --scorer '_score = geo_distance(location, "128515259x503187188")'