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);