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

すべて一致クエリを使用して、テーブル内のすべての行を照合し、テーブル内の行の総数をクエリしたり、複数のランダムな行を返したりできます。

前提条件

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

パラメーター

パラメーター	説明
table_name	データテーブルの名前。
index_name	検索インデックスの名前。
offset	現在のクエリが開始される位置。
limit	現在のクエリで返す行の最大数。クエリ条件を満たす行の数を、特定のデータを返さずにクエリするには、Limit を 0 に設定します。この方法では、Tablestore はテーブルから特定のデータを取得せずに、クエリ条件を満たす行の数を返します。
get_total_count	クエリ条件を満たす行の総数を返すかどうかを指定します。このパラメーターのデフォルト値は false で、クエリ条件を満たす行の総数は返されません。このパラメーターを true に設定すると、クエリのパフォーマンスが低下します。
collapse	返される結果が指定された列に基づいて折りたたまれることを指定します。
query_type	クエリタイプ。一致クエリを使用するには、このパラメーターを `QueryTypeConst::MATCH_ALL_QUERY` に設定します。
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` に設定すると、プライマリキー列のみが返されます。

例

次のサンプルコードは、検索インデックスを使用して、php_sdk_test テーブルから最大 10 個の一意のキーワードレコードを取得し、col1 列と col2 列のデータを返す方法を示しています。

$request = array(
    'table_name' => 'php_sdk_test',
    'index_name' => 'php_sdk_test_search_index',
    'search_query' => array(
        'offset' => 0,
        'limit' => 10,
        'get_total_count' => true,
        'collapse' => array(
            'field_name' => 'keyword'
        ),
        'query' => array(
            'query_type' => QueryTypeConst::MATCH_ALL_QUERY
        ),
//        'sort' => array(// 必要に応じて特定のソート方法を指定します。
//            array(
//                'field_sort' => array(
//                    'field_name' => 'keyword',
//                    'order' => SortOrderConst::SORT_ORDER_ASC
//                )
//            ),
//        ),
        'token' => null,
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('col1', 'col2')
    )
);
$response = $otsClient->search($request);

FAQ

テーブル内の行の総数をクエリするにはどうすればよいですか？

参考資料

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