PHP SDK for Tablestore を使用して一致フレーズクエリを実行する - Tablestore

一致フレーズクエリは、一致クエリと似ていますが、一致フレーズクエリはトークンの位置を評価する点が異なります。行がクエリ条件を満たすのは、行内のトークンの順序と位置が、キーワードに含まれるトークンの順序と位置と一致する場合のみです。クエリ対象のフィールドのトークン化方式がファジートークン化の場合、一致フレーズクエリはワイルドカードクエリよりも低いレイテンシで実行されます。

前提条件

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

パラメーター

パラメーター	説明
table_name	データテーブルの名前。
index_name	検索インデックスの名前。
offset	現在のクエリが開始される位置。
limit	現在のクエリで返される最大行数。特定のデータを返さずに、クエリ条件を満たす行数のみをクエリするには、Limit を 0 に設定します。この方法では、Tablestore はテーブルからの特定のデータなしで、クエリ条件を満たす行数を返します。
get_total_count	クエリ条件を満たす行の総数を返すかどうかを指定します。デフォルト値: false。false の値は、クエリ条件を満たす行の総数を返さないことを指定します。このパラメーターを true に設定すると、クエリのパフォーマンスが低下します。
query_type	クエリタイプ。一致フレーズクエリを使用するには、このパラメーターを `QueryTypeConst::MATCH_PHRASE_QUERY` に設定します。
field_name	一致させるフィールドの名前。一致フレーズクエリは TEXT フィールドに適用されます。
text	一致フレーズクエリを実行するときに、フィールドの値と一致させるために使用されるキーワード。一致させるフィールドが TEXT フィールドの場合、キーワードは、検索インデックスの作成時に指定したアナライザータイプに基づいて複数のトークンにトークン化されます。検索インデックスの作成時にアナライザータイプを指定しない場合は、単一単語のトークン化が実行されます。たとえば、「this is」というフレーズを使用して一致フレーズクエリを実行すると、「..., this is tablestore」と「this is a table」が返されます。「this table is ...」または「is this a table」は返されません。
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` に設定すると、プライマリキー列のみが返されます。

例

次のサンプルコードは、一致フレーズクエリを使用して、text 列の値が「text 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::MATCH_PHRASE_QUERY,
            'query' => array(
                'field_name' => 'text',
                'text' => 'text keyword'
            )
        ),
        '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('text')
    )
);
$response = $otsClient->search($request);

FAQ

参考資料

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