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

Tablestore:ワイルドカードクエリ

最終更新日:Oct 09, 2026

ワイルドカードクエリを実行する際、クエリでアスタリスク (*) と疑問符 (?) のワイルドカード文字を使用してデータを検索できます。アスタリスク (*) は、検索語の前、後、または途中の任意の長さの文字列に一致します。疑問符 (?) は、特定の位置の 1 文字に一致します。文字列はアスタリスク (*) または疑問符 (?) で始めることができます。たとえば、「table*e」という文字列を検索する場合、「tablestore」が一致します。

クエリパターンが *word* の場合 (SQL の WHERE field_a LIKE '%word%' と同等)、トークンベースのワイルドカードクエリ機能を使用すると、パフォーマンスが向上します。データサイズの増加に伴うパフォーマンスの低下はありません。

説明

NOT LIKE 演算子を使用する場合は、WildcardQuery を BoolQuery の must_not_queries と組み合わせて使用する必要があります。

前提条件

パラメータ

パラメータ

説明

table_name

データテーブルの名前。

index_name

検索インデックスの名前。

offset

現在のクエリの開始位置。

limit

現在のクエリが返す最大行数。

get_total_count

クエリ条件に一致する行の総数を返すかどうかを指定します。このパラメータのデフォルト値は false で、クエリ条件に一致する行の総数は返されません。

get_total_count パラメータを true に設定すると、クエリのパフォーマンスが低下します。

query_type

クエリのタイプです。この値は QueryTypeConst::WILDCARD_QUERY に設定します。

field_name

クエリ対象の列の名前。

value

ワイルドカード文字を含む文字列。文字列の長さは 32 文字を超えることはできません。

sort

レスポンス内の行をソートする方法。詳細については、「ソートとページング」をご参照ください。

columns_to_get

クエリ条件に一致する各行のすべての列を返すかどうかを指定します。このパラメータには return_type と return_names を設定できます。

  • return_type を ColumnReturnTypeConst::RETURN_SPECIFIED に設定した場合、return_names を使用して返す列を指定できます。

  • return_type を ColumnReturnTypeConst::RETURN_ALL に設定した場合、すべての列が返されます。

  • return_type を ColumnReturnTypeConst::RETURN_ALL_FROM_INDEX に設定した場合、検索インデックス内のすべての列が返されます。

  • return_type を ColumnReturnTypeConst::RETURN_NONE に設定した場合、プライマリキー列のみが返されます。

例

次のサンプルコードは、テーブルの 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 を呼び出して並列スキャン機能を使用できます。詳細については、「並列スキャン」をご参照ください。