PHP SDK for Tablestore を使用したタームクエリの実行 - Tablestore

タームクエリを実行して、フィールドの指定された値と完全に一致するデータをクエリできます。タームクエリは、文字列一致条件に基づくクエリに似ています。 TEXT 列がクエリされ、行内の少なくとも 1 つのトークンがキーワードと完全に一致する場合、その行はクエリ条件を満たします。キーワードはトークン化されません。

前提条件

OTSClient インスタンスが初期化されていること。詳細については、OTSClient インスタンスの初期化を参照してください。
データテーブルが作成されていること。データがテーブルに書き込まれていること。詳細については、データテーブルの作成およびデータの書き込みを参照してください。
データテーブルの検索インデックスが作成されていること。詳細については、検索インデックスの作成を参照してください。

パラメーター

パラメーター	説明
table_name	データテーブルの名前。
index_name	検索インデックスの名前。
offset	現在のクエリが開始される位置。
limit	現在のクエリで返される最大行数。行の特定のデータをクエリせずに、クエリ条件を満たす行数のみをクエリするには、このパラメーターを 0 に設定します。
get_total_count	クエリ条件を満たす行の総数を返すかどうかを指定します。デフォルト値: false。false の値は、クエリ条件を満たす行の総数が返されないことを指定します。このパラメーターを true に設定すると、クエリのパフォーマンスが低下します。
query_type	クエリタイプ。タームクエリを使用するには、このパラメーターを `QueryTypeConst::TERM_QUERY` に設定します。
field_name	一致させたいフィールドの名前。
term	タームクエリを実行するときにフィールド値と一致させるために使用されるキーワード。この単語はトークン化されません。代わりに、単語全体がフィールド値との一致に使用されます。列のタイプが TEXT の場合、Tablestore は文字列をトークン化し、トークンを使用してキーワードと一致させます。行内の少なくとも 1 つのトークンがキーワードと完全に一致すると、行はクエリ条件を満たします。たとえば、TEXT 文字列 "tablestore is cool" は "tablestore"、"is"、"cool" にトークン化されます。これらのトークンのいずれかを検索文字列として指定すると、"tablestore is cool" を含むクエリ結果を取得できます。
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 列に "keyword" という用語を含むすべての行をクエリする方法を示しています。

$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::TERM_QUERY,
            'query' => array(
                'field_name' => 'keyword',
                'term' => 'keyword'
            )
        ),
        'sort' => array(
            array(
                'field_sort' => array(
                    'field_name' => 'keyword',
                    'order' => SortOrderConst::SORT_ORDER_ASC
                )
            ),
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_ALL,
        'return_names' => array('keyword', 'long')
    )
);
$response = $otsClient->search($request);

FAQ

参考資料

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