ワイルドカードクエリの実行（PHP用Tablestore SDKを使用） - Tablestore

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

説明

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	クエリタイプ。`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);

FAQ

参考資料

検索インデックスを使用してデータをクエリする場合、次のクエリメソッドを使用できます：タームクエリ、タームズクエリ、マッチオールクエリ、マッチクエリ、マッチフレーズクエリ、プレフィックスクエリ、範囲クエリ、ワイルドカードクエリ、ブールクエリ、ジオクエリ、ネストされたクエリ、および存在クエリ。ビジネス要件に基づいて、さまざまなクエリメソッドを使用して複数のディメンションからデータをクエリできます。
クエリ条件を満たす行をソートまたはページングする場合は、ソートおよびページング機能を使用できます。詳細については、ソートとページングを参照してください。
特定の列に基づいて結果セットを折りたたむ場合は、折りたたみ（重複排除）機能を使用できます。このようにして、指定されたタイプのデータはクエリ結果に一度だけ表示されます。詳細については、折りたたみ（重複排除）を参照してください。
データテーブルのデータ（極値、合計、行の総数など）を分析する場合は、集計操作を実行するか、SQLステートメントを実行できます。詳細については、集計およびSQLクエリを参照してください。
行をソートする必要なく、クエリ条件を満たすすべての行をすばやく取得する場合は、ParallelScanおよびComputeSplits操作を呼び出して並列スキャン機能を使用できます。詳細については、並列スキャンを参照してください。