PHP SDK for Tablestore を使用して terms クエリを実行する - Tablestore

terms クエリは、term クエリに似ていますが、terms クエリは複数の用語をサポートしている点が異なります。指定された列の値と少なくとも 1 つのキーワードが一致する場合、データの行が返されます。terms クエリは、SQL ステートメントの IN 演算子と同じ方法で使用できます。

前提条件

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

パラメーター

パラメーター	説明
table_name	データテーブルの名前。
index_name	検索インデックスの名前。
offset	現在のクエリが開始される位置。
limit	現在のクエリで返される最大行数。行の特定のデータをクエリせずに、クエリ条件を満たす行の数のみをクエリするには、limit パラメーターを 0 に設定します。
get_total_count	クエリ条件を満たす行の総数を返すかどうかを指定します。デフォルト値は false で、クエリ条件を満たす行の総数は返されません。このパラメーターを true に設定すると、クエリのパフォーマンスが低下します。
query_type	クエリの種類。このパラメーターを `QueryTypeConst::TERMS_QUERY` に設定します。
field_name	クエリ対象の列の名前。
terms	terms クエリを実行するときに、列の値と照合するために使用するキーワード。列の値と少なくとも 1 つのキーワードが一致する場合、データの行が返されます。
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」または「php」である行をクエリする方法を示しています。

$request = array(
    'table_name' => 'php_sdk_test',
    'index_name' => 'php_sdk_test_search_index',
    'search_query' => array(
        'offset' => 0,
        'limit' => 5,
        'get_total_count' => true,
        'query' => array(
            'query_type' => QueryTypeConst::TERMS_QUERY,
            'query' => array(
                'field_name' => 'keyword',
                'terms' => array(
                    "keyword",
                    "php"
                )
            )
        ),
        'sort' => array(
            array(
                'field_sort' => array(
                    'field_name' => 'long',
                    'order' => SortOrderConst::SORT_ORDER_DESC,
                    'mode' => SortModeConst::SORT_MODE_AVG
                )
            )
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('keyword', 'long')
    )
);
$response = $otsClient->search($request);

FAQ

参考資料

検索インデックスを使用してデータをクエリする場合、次のクエリメソッドを使用できます。term クエリ、terms クエリ、match all クエリ、match クエリ、match phrase クエリ、prefix クエリ、range クエリ、wildcard クエリ、Boolean クエリ、geo クエリ、nested クエリ、exists クエリ。ビジネス要件に基づいて、さまざまなクエリメソッドを使用して複数のディメンションからデータをクエリできます。
クエリ条件を満たす行をソートまたはページングする場合、ソートおよびページング機能を使用できます。詳細については、ソートとページングをご参照ください。
特定の列に基づいて結果セットを折りたたむ場合は、折りたたみ (個別) 機能を使用できます。このようにして、指定されたタイプのデータはクエリ結果に一度だけ表示されます。詳細については、折りたたみ (個別)をご参照ください。
データテーブル内のデータ (極値、合計、行の総数など) を分析する場合は、集計操作を実行するか、SQL ステートメントを実行できます。詳細については、集計およびSQL クエリをご参照ください。
行をソートする必要なく、クエリ条件を満たすすべての行をすばやく取得する場合は、ParallelScan および ComputeSplits オペレーションを呼び出して、パラレルスキャン機能を使用できます。詳細については、パラレルスキャンをご参照ください。