PHP SDK for Tablestore を使用した exists クエリの発行 - Tablestore

Exists クエリは、NULL クエリまたは NULL 値クエリとも呼ばれます。このクエリは、スパースデータで使用され、行の列が存在するかどうかを判断します。たとえば、address 列の値が空でない行をクエリできます。

説明

列に空の値が含まれているかどうかを確認するには、ExistsQuery を BoolQuery の must_not_queries と共に使用する必要があります。
次のいずれかの条件が満たされている場合、システムは列が存在しないと見なします。この例では、city 列を使用します。
- 検索インデックスの city 列の型が、keyword などの基本型です。データテーブルに city 列が存在しない行がある場合、検索インデックスは city 列が存在しないと見なします。
- 検索インデックスの city 列の型が、keyword などの基本型です。データテーブルの city 列の値が空の配列である行 ("city" = "[]") がある場合、検索インデックスは city 列が存在しないと見なします。

前提条件

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

パラメーター

パラメーター	説明
table_name	データテーブルの名前。
index_name	検索インデックスの名前。
field_name	クエリする列の名前。
query_type	クエリタイプ。クエリタイプを QueryTypeConst::EXISTS_QUERY に設定します。説明ネストされた列を直接クエリすることはできません。ネストされた列をクエリするには、ネストされた列のパスとサブクエリを指定して NestedQuery をカプセル化する必要があります。サブクエリは任意のタイプのクエリにすることができます。詳細については、ネストクエリを参照してください。

例

このセクションでは、exists クエリを実行する方法の例を示します。

text 列に空でない行をクエリする

次のサンプルコードは、テーブルの text 列に空でない行をクエリする方法を示しています。

$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::EXISTS_QUERY,
            'query' => array(
                'field_name' => 'text' // text 列を指定
            )
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('keyword', 'long', 'array')
    )
);
$response = $otsClient->search($request);

ネストされた列のサブカラムに空でない行をクエリする

次のサンプルコードは、テーブルのネストされた列の nested_long サブカラムに空でない行をクエリする方法を示しています。

$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::NESTED_QUERY,
            'query' => array(
                'path' => "nested", // ネストされた列のパス
                'query' => array(
                    'query_type' => QueryTypeConst::EXISTS_QUERY,
                    'query' => array(
                        'field_name' => 'nested.nested_long', // ネストされた列のサブカラム nested_long を指定
                    )
                ),
                'score_mode' => ScoreModeConst::SCORE_MODE_AVG
            )
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('nested')
    )
);
$response = $this->otsClient->search($request);

Tablestore:Exists クエリ

前提条件

パラメーター

例

text 列に空でない行をクエリする

ネストされた列のサブカラムに空でない行をクエリする

FAQ

関連情報