ExistsQuery也叫NULL查询或者空值查询,一般用于判断稀疏数据中某一行的某一列是否存在。例如查询所有数据中address列不为空的行。
-
要对Nested字段进行列存在性查询(ExistsQuery)时,请使用嵌套类型查询(NestedQuery)进行嵌套。
-
如果需要查询某一列为空,则ExistsQuery需要和BoolQuery中的mustNotQueries结合使用。
-
以下情况会认为某一列不存在,以city列为例说明。
-
city列在多元索引中的数据类型为keyword(或其他基础类型),如果数据表中某行数据不存在city列,则多元索引认为该行数据的city列不存在。
-
city列在多元索引中的数据类型为keyword(或其他基础类型)数组,如果数据表中某行数据的city列为空数组,即"city" = "[]",则多元索引认为该行数据的city列不存在。
-
接口
列存在性查询的接口为Search或者ParallelScan,具体的Query类型为ExistsQuery。
参数
|
参数 |
说明 |
|
fieldName |
列名。 |
|
query |
设置查询类型为ExistsQuery。 |
|
getTotalCount |
是否返回匹配的总行数,默认为false,表示不返回。 返回匹配的总行数会影响查询性能。 |
|
tableName |
数据表名称。 |
|
indexName |
多元索引名称。 |
|
columnsToGet |
是否返回所有列,包含returnAll和columns设置。 returnAll默认为false,表示不返回所有列,此时可以通过columns指定返回的列;如果未通过columns指定返回的列,则只返回主键列。 当设置returnAll为true时,表示返回所有列。 |
使用方式
您可以使用控制台、命令行工具或者SDK进行列存在性查询。进行列存在性查询之前,您需要完成如下准备工作。
使用阿里云账号或者具有表格存储操作权限的 RAM 用户进行操作。如果需要为 RAM 用户授权表格存储操作权限,请参见通过RAM Policy为RAM用户授权进行配置。
使用 SDK 方式和命令行工具方式进行操作时,如果当前无可用 AccessKey,则需要为阿里云账号或者 RAM 用户创建 AccessKey。
已创建数据表。
已为数据表创建多元索引。
使用 SDK 方式进行操作时,还需要完成初始化Tablestore Client。
使用命令行工具方式进行操作前,还需要完成下载并启动命令行工具,然后配置接入实例信息并选择要操作的表。具体操作,请参见下载命令行工具、启动并配置接入信息和数据表操作。
计费说明
使用 VCU 模式(原预留模式)时,使用多元索引查询数据会消耗 VCU 的计算资源。使用 CU 模式(原按量模式)时,使用多元索引查询数据会消耗读吞吐量。更多信息,请参见多元索引计量计费。