すべてのプロダクト
Search
ドキュメントセンター

Tablestore:MatchQuery

最終更新日:Dec 28, 2024

MatchQuery は、一致クエリの構成を指定します。一致クエリを使用して、あいまい一致に基づいてテーブル内のデータをクエリできます。

データ構造

message MatchQuery {
    optional string field_name = 1; // クエリ対象の列の名前。
    optional string text = 2; // 一致クエリを実行するときに列の値を照合するために使用されるキーワード。
    optional int32 minimum_should_match = 3; // 列値に含まれる一致したトークンの最小数。
    optional QueryOperator operator = 4; // クエリ演算子。
    optional float weight = 5; // クエリ条件の重み設定。
}

パラメーター

タイプ

必須

説明

field_name

string

はい

クエリ対象の列の名前。

列のタイプは TEXT にすることができます。

text

string

はい

一致クエリを実行するときに列の値を照合するために使用されるキーワード。

クエリ対象の列のタイプが TEXT の場合、キーワードは、検索インデックスの作成時に指定したアナライザータイプに基づいて複数のトークンにトークン化されます。検索インデックスの作成時にアナライザータイプを指定しない場合、デフォルトでは単一単語トークン化が実行されます。

たとえば、クエリ対象の列のタイプが TEXT で、アナライザータイプが単一単語トークン化の場合、「this is」をキーワードとして使用すると、「..., this is tablestore」、「is this tablestore」、「tablestore is cool」、「this」、および「is」などのクエリ結果が返されます。

minimum_should_match

int32

いいえ

列値に含まれる一致したトークンの最小数。このパラメーターは、OR 論理演算子と一緒に使用する必要があります。

行の field_name 列の値に一致するトークンが少なくとも最小数含まれている場合にのみ、行が返されます。

operator

QueryOperator

いいえ

クエリ演算子。AND または OR 演算子を指定できます。デフォルトでは、OR が論理演算子として使用されます。これは、列値に少なくとも最小数のトークンが含まれている場合、行がクエリ条件を満たすことを示します。

weight

float

いいえ

クエリ条件の重み設定。