プレフィックスクエリの実行（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::PREFIX_QUERY`に設定します。
field_name	クエリする列の名前。
prefix	プレフィックス。プレフィックス条件の照合に使用される列がTEXT列の場合、その列はトークン化されます。少なくとも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列にプレフィックス「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::PREFIX_QUERY,
            'query' => array(
                'field_name' => 'keyword',
                'prefix' => 'key'
            )
        ),
        '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')
    )
);
$response = $otsClient->search($request);

FAQ

参考資料

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