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

说明
  • 如果需要查询某一列为空,则需要和BoolQuery中的must_not_queries结合使用。
  • 以下情况会认为某一列不存在,以city列为例说明。
    • city列在多元索引中的数据类型为keyword(或其他基础类型),如果数据表中某行数据不存在city列,则多元索引认为该行数据的city列不存在。
    • city列在多元索引中的数据类型为keyword(或其他基础类型)数组,如果数据表中某行数据的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);