PHP SDK for Tablestore を使用した範囲クエリの実行 - Tablestore

範囲クエリを実行して、指定した範囲内にあるデータをクエリできます。フィールドのタイプが TEXT の場合、フィールド値はトークン化されます。行内のトークンの少なくとも 1 つがクエリ範囲と一致する場合、行はクエリ条件を満たします。

前提条件

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

パラメーター

パラメーター	説明
table_name	データテーブルの名前。
index_name	検索インデックスの名前。
offset	現在のクエリが開始される位置。
limit	現在のクエリで返される行の最大数。行の特定のデータをクエリせずに、クエリ条件を満たす行の数のみをクエリするには、このパラメーターを 0 に設定します。
get_total_count	クエリ条件を満たす行の総数を返すかどうかを指定します。このパラメーターのデフォルト値は false で、クエリ条件を満たす行の総数は返されません。このパラメーターを true に設定すると、クエリのパフォーマンスが低下します。
query_type	クエリタイプ。範囲クエリを使用するには、このパラメーターを `QueryTypeConst::RANGE_QUERY` に設定します。
field_name	一致させるフィールドの名前。
range_from	クエリが開始される値。
range_to	クエリが終了する値。
include_lower	range_from パラメーターの値をレスポンスに含めるかどうかを指定します。このパラメーターの値はブール型です。
include_upper	range_to パラメーターの値をレスポンスに含めるかどうかを指定します。このパラメーターの値はブール型です。
sort	レスポンス内の行をソートするために使用するメソッド。詳細については、ソートとページングを参照してください。
columns_to_get	クエリ条件を満たす各行のすべての列を返すかどうかを指定します。このパラメーターには、return_type フィールドと column_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` に設定すると、プライマリキー列のみが返されます。

例

次のサンプルコードは、long 列の値が 100 以上 101 未満の行をクエリする方法の例を示しています。この例では、レスポンス内の行は 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::RANGE_QUERY,
            'query' => array(
                'field_name' => 'long',
                'range_from' => 100,
                'include_lower' => true,
                'range_to' => 101,
                'include_upper' => false
            )
        ),
        '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('double', 'long', 'keyword')
    )
);
$response = $otsClient->search($request);

FAQ

参考資料

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