English page7.12.11. query¶
7.12.11.1. 概要¶
query は、select の --match_columns と --query 引数の機能を関数として提供します。select の --filter 引数で複数の query 関数を指定することができます。
そのような柔軟性があるので、 複数の query 関数を組合せることで全文検索の振舞いを制御することができます。
query は select コマンドの --filter 内でのみ指定できます。
7.12.11.2. 構文¶
query は2つの引数が必要です。 match_columns と query_string です。
引数の query_expander や substitution_table は省略可能です。
query(match_columns, query_string)
query(match_columns, query_string, query_expander)
query(match_columns, query_string, substitution_table)
7.12.11.3. 使い方¶
使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。
サンプルスキーマ:
実行例:
table_create Documents TABLE_NO_KEY
# [[0, 1337566253.89858, 0.000355720520019531], true]
column_create Documents content COLUMN_SCALAR Text
# [[0, 1337566253.89858, 0.000355720520019531], true]
table_create Terms TABLE_PAT_KEY|KEY_NORMALIZE ShortText --default_tokenizer TokenBigram
# [[0, 1337566253.89858, 0.000355720520019531], true]
column_create Terms documents_content_index COLUMN_INDEX|WITH_POSITION Documents content
# [[0, 1337566253.89858, 0.000355720520019531], true]
table_create Users TABLE_NO_KEY
# [[0, 1337566253.89858, 0.000355720520019531], true]
column_create Users name COLUMN_SCALAR ShortText
# [[0, 1337566253.89858, 0.000355720520019531], true]
column_create Users memo COLUMN_SCALAR ShortText
# [[0, 1337566253.89858, 0.000355720520019531], true]
table_create Lexicon TABLE_HASH_KEY ShortText \
--default_tokenizer TokenBigramSplitSymbolAlphaDigit \
--normalizer NormalizerAuto
column_create Lexicon users_name COLUMN_INDEX|WITH_POSITION Users name
# [[0, 1337566253.89858, 0.000355720520019531], true]
column_create Lexicon users_memo COLUMN_INDEX|WITH_POSITION Users memo
# [[0, 1337566253.89858, 0.000355720520019531], true]
サンプルデータ:
実行例:
load --table Users
[
{"name": "Alice", "memo": "groonga user"},
{"name": "Alisa", "memo": "mroonga user"},
{"name": "Bob", "memo": "rroonga user"},
{"name": "Tom", "memo": "nroonga user"},
{"name": "Tobby", "memo": "groonga and mroonga user. mroonga is ..."},
]
# [[0, 1337566253.89858, 0.000355720520019531], true]
# [[0, 1337566253.89858, 0.000355720520019531], 5]
--match_columns と --query 引数を使わずにキーワード'alice'を query 関数を使って検索する簡単な使用例です。
実行例:
select Users --output_columns name,_score --filter 'query("name * 10", "alice")'
# [
# [
# 0,
# 1337566253.89858,
# 0.000355720520019531
# ],
# [
# [
# [
# 1
# ],
# [
# [
# "name",
# "ShortText"
# ],
# [
# "_score",
# "Int32"
# ]
# ],
# [
# "Alice",
# 10
# ]
# ]
# ]
# ]
上記のクエリを実行する際、'alice'というキーワードには重みづけとして値10を設定します。
query あり/なしで対照的な例がこちらです。
実行例:
select Users --output_columns name,memo,_score --match_columns "memo * 10" --query "memo:@groonga OR memo:@mroonga OR memo:@user" --sortby -_score
# [
# [
# 0,
# 1337566253.89858,
# 0.000355720520019531
# ],
# [
# [
# [
# 5
# ],
# [
# [
# "name",
# "ShortText"
# ],
# [
# "memo",
# "ShortText"
# ],
# [
# "_score",
# "Int32"
# ]
# ],
# [
# "Tobby",
# "groonga and mroonga user. mroonga is ...",
# 4
# ],
# [
# "Alice",
# "groonga user",
# 2
# ],
# [
# "Alisa",
# "mroonga user",
# 2
# ],
# [
# "Bob",
# "rroonga user",
# 1
# ],
# [
# "Tom",
# "nroonga user",
# 1
# ]
# ]
# ]
# ]
この場合、'groonga'と'mroonga'と'user'というキーワードは同じ重みづけがされています。この方法ではキーワードごとに異なる重みづけを行うことはできません。
実行例:
select Users --output_columns name,memo,_score --filter 'query("memo * 10", "groonga") || query("memo * 20", "mroonga") || query("memo * 1", "user")' --sortby -_score
# [
# [
# 0,
# 1337566253.89858,
# 0.000355720520019531
# ],
# [
# [
# [
# 5
# ],
# [
# [
# "name",
# "ShortText"
# ],
# [
# "memo",
# "ShortText"
# ],
# [
# "_score",
# "Int32"
# ]
# ],
# [
# "Tobby",
# "groonga and mroonga user. mroonga is ...",
# 51
# ],
# [
# "Alisa",
# "mroonga user",
# 21
# ],
# [
# "Alice",
# "groonga user",
# 11
# ],
# [
# "Tom",
# "nroonga user",
# 1
# ],
# [
# "Bob",
# "rroonga user",
# 1
# ]
# ]
# ]
# ]
一方、複数の query を指定することで、'groonga'と'mroonga'と'user'それぞれのキーワードに対し異なる重みづけを行えます。
結果として、意図した様に異なる重みづけを行いつつ全文検索の振舞いを制御することができます。
7.12.11.4. 引数¶
7.12.11.4.1. 必須引数¶
必須引数は二つあります。 match_columns と query_string です。
7.12.11.4.1.1. match_columns¶
query_string パラメーターの値で全文検索するときのデフォルトの検索対象カラムを指定します。このパラメーターは select の match_columns パラメーターと同じ役割です。
7.12.11.4.1.2. query_string¶
クエリー構文 で検索条件を指定します。このパラメーターは select コマンドの query パラメーターと同じ役割です。
select コマンドの query については match_columns を参照してください。
7.12.11.4.2. 省略可能引数¶
いくつか省略可能な引数があります。
7.12.11.4.2.1. query_expander¶
クエリ展開に使うプラグイン名を指定します。
QueryExpanderTSV は公式リリースに含まれているプラグインの1つです。
詳細については QueryExpanderTSV を参照してください。
7.12.11.4.2.2. 置換テーブル¶
置換テーブルとカラム名を ${TABLE}.${COLUMN} という書式でクエリ展開のために指定します。
詳細については query_expander を参照してください。
7.12.11.5. 戻り値¶
query は1つでもレコードがマッチしたかどうかを返します。もし、1つ以上のレコードがマッチしたら true を返します。1つもマッチしなかったら false を返します。
7.12.11.6. TODO¶
query_flagsのサポート