ワイルドカードクエリを実行する際、クエリでアスタリスク (*) と疑問符 (?) のワイルドカード文字を使用してデータを検索できます。アスタリスク (*) は、検索語の前、後、または途中の任意の長さの文字列に一致します。疑問符 (?) は、特定の位置の 1 文字に一致します。文字列はアスタリスク (*) または疑問符 (?) で始めることができます。たとえば、「table*e」という文字列を検索する場合、「tablestore」が一致します。
クエリパターンが *word* の場合 (SQL の WHERE field_a LIKE '%word%' と同等)、トークンベースのワイルドカードクエリ機能を使用すると、パフォーマンスが向上します。データサイズの増加に伴うパフォーマンスの低下はありません。
NOT LIKE 演算子を使用する場合は、WildcardQuery を BoolQuery の must_not_queries と組み合わせて使用する必要があります。
前提条件
-
OTSClient インスタンスが初期化されていること。詳細については、「OTSClient インスタンスの初期化」をご参照ください。
-
データテーブルが作成され、データが書き込まれていること。詳細については、「データテーブルの作成」および「データの書き込み」をご参照ください。
-
データテーブルの検索インデックスが作成されていること。詳細については、「検索インデックスの作成」をご参照ください。
パラメータ
|
パラメータ |
説明 |
|
table_name |
データテーブルの名前。 |
|
index_name |
検索インデックスの名前。 |
|
offset |
現在のクエリの開始位置。 |
|
limit |
現在のクエリが返す最大行数。 |
|
get_total_count |
クエリ条件に一致する行の総数を返すかどうかを指定します。このパラメータのデフォルト値は false で、クエリ条件に一致する行の総数は返されません。 get_total_count パラメータを true に設定すると、クエリのパフォーマンスが低下します。 |
|
query_type |
クエリのタイプです。この値は |
|
field_name |
クエリ対象の列の名前。 |
|
value |
ワイルドカード文字を含む文字列。文字列の長さは 32 文字を超えることはできません。 |
|
sort |
レスポンス内の行をソートする方法。詳細については、「ソートとページング」をご参照ください。 |
|
columns_to_get |
クエリ条件に一致する各行のすべての列を返すかどうかを指定します。このパラメータには return_type と return_names を設定できます。
|
例
次のサンプルコードは、テーブルの keyword 列で key* 条件に一致するデータをクエリする方法を示しています:
$request = array(
'table_name' => 'php_sdk_test',
'index_name' => 'php_sdk_test_search_index',
'search_query' => array(
'offset' => 0,
'limit' => 2,
'get_total_count' => true,
'query' => array(
'query_type' => QueryTypeConst::WILDCARD_QUERY,
'query' => array(
'field_name' => 'keyword',
'value' => 'key*'
)
),
'sort' => array(
array(
'field_sort' => array(
'field_name' => 'keyword',
'order' => SortOrderConst::SORT_ORDER_ASC
)
),
)
),
'columns_to_get' => array(
'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
'return_names' => array('keyword')
)
);
$response = $otsClient->search($request);
よくある質問
関連ドキュメント
-
検索インデックスを使用してデータをクエリする際は、次のクエリ方法を使用できます:term クエリ、terms クエリ、match_all クエリ、match クエリ、match_phrase クエリ、prefix クエリ、range クエリ、ワイルドカードクエリ、bool クエリ、geo クエリ、nested クエリ、exists クエリ。ビジネス要件に基づいて、さまざまなクエリ方法を使用して、複数の次元からデータをクエリできます。
クエリ条件に一致する行をソートまたはページングする場合は、ソートとページング機能を使用できます。詳細については、「ソートとページング」をご参照ください。
特定の列に基づいて結果セットを折りたたむ場合は、折りたたみ (distinct) 機能を使用できます。これにより、クエリ結果に指定されたタイプのデータが 1 回だけ表示されます。詳細については、「折りたたみ (distinct)」をご参照ください。
-
データテーブル内のデータを分析する場合 (極値、合計、総行数の取得など)、アグリゲーションを実行するか、SQL ステートメントを実行できます。詳細については、「アグリゲーション」および「SQL クエリ」をご参照ください。
-
行をソートせずにクエリ条件に一致するすべての行を迅速に取得する場合は、ParallelScan および ComputeSplits API を呼び出して並列スキャン機能を使用できます。詳細については、「並列スキャン」をご参照ください。