ExistsQuery也叫NULL查询或者空值查询。一般用于稀疏数据中，用于判断某一行的某一列是否存在，例如查询所有数据中，address列不为空的行。

说明
  • 如果需要查询某一列为空，则需要和BoolQuery中的must_not_queries结合使用。
  • 以下情况会认为某一列不存在，以 "city" 列为例说明。
    • city列在本行数据中不存在。
    • city列是空数组，即 "city" = "[]"。

前提条件

  • 已初始化OTSClient，详情请参见初始化。
  • 已创建数据表并写入数据。
  • 已在数据表上创建多元索引，详情请参见创建多元索引。

参数

参数 说明
table_name 数据表名称。
index_name 多元索引名称。
field_name 列名。
query_type 设置查询类型为QueryTypeConst::EXISTS_QUERY。
说明 嵌套类型不能直接查询，需要通过NestedQuery包装，NestedQuery中需要指定嵌套类型的列的路径和一个子查询，其中子查询可以是任意Query类型。详情请参见嵌套类型查询。

示例

  • 示例1

    查询表中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'
            )
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('keyword', 'long', 'array')
    )
);
$response = $otsClient->search($request);
  • 示例2

    查询嵌套类型的nested列中的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',
                    )
                ),
                'score_mode' => ScoreModeConst::SCORE_MODE_AVG
            )
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('nested')
    )
);
$response = $this->otsClient->search($request);