参数
参数 | 说明 |
fieldName | 要匹配的字段。 |
from | 起始位置的值。 设置范围条件时,大于(>)可以使用greaterThan表示,大于等于(>=)可以使用greaterThanOrEqual表示。 |
to | 结束位置的值。 设置范围条件时,小于(<)可以使用lessThan表示;小于等于(<=)可以使用lessThanOrEqual表示。 |
includeLower | 结果中是否需要包括from值,类型为Boolean。 |
includeUpper | 结果中是否需要包括to值,类型为Boolean。 |
query | 设置查询类型为RangeQuery。 |
sort | 按照指定方式排序,详情请参见排序和翻页。 |
getTotalCount | 是否返回匹配的总行数,默认为false,表示不返回。 返回匹配的总行数会影响查询性能。 |
tableName | 数据表名称。 |
indexName | 多元索引名称。 |
columnsToGet | 是否返回所有列,包含returnAll和columns设置。 returnAll默认为false,表示不返回所有列,此时可以通过columns指定返回的列;如果未通过columns指定返回的列,则只返回主键列。 当设置returnAll为true时,表示返回所有列。 |
使用方式
您可以使用控制台、命令行工具或者SDK进行范围查询。进行范围查询之前,您需要完成如下准备工作。
使用控制台
进入索引管理页签。
登录表格存储控制台。
在页面上方,选择资源组和地域。
在概览页面,单击实例名称或在操作列单击实例管理。
在实例详情页签下的数据表列表页签,单击数据表名称或在操作列单击索引管理。
在索引管理页签,单击目标多元索引操作列的搜索。
在查询数据对话框,查询数据。
系统默认返回所有列,如需显示指定属性列,关闭获取所有列并输入需要返回的属性列,多个属性列之间用半角逗号(,)隔开。
根据需要选择逻辑操作符为 And、Or 或者 Not。
当选择逻辑操作符为 And 时,返回满足指定条件的数据。当选择逻辑操作符为 Or 时,如果配置了单个条件,则返回满足指定条件的数据;如果配置了多个条件,则返回满足任意一个条件的数据。当选择逻辑操作符为 Not 时,返回不满足指定条件的数据。
选择索引字段,单击添加。
设置索引字段的查询类型为范围查询(RangeQuery)和输入查询范围。
查询范围为左闭右开的区间,请根据需要配置。
系统默认关闭排序功能,如需根据指定字段对返回结果进行排序,打开是否排序开关后,根据需要添加要进行排序的字段并配置排序方式。
系统默认关闭统计功能,如需对指定字段进行数据统计,打开是否统计开关后,根据需要添加要进行统计的字段和配置统计信息。
单击确定。
符合查询条件的数据会显示在索引管理页签中。
使用命令行工具
通过命令行工具执行search命令使用多元索引查询数据。更多信息,请参见多元索引。
执行search命令使用search_index多元索引查询表中数据,并返回所有建立索引的列。
search -n search_index --return_all_indexed
根据系统提示输入查询条件,示例如下:
{
"Offset": -1,
"Limit": 10,
"Collapse": null,
"Sort": null,
"GetTotalCount": true,
"Token": null,
"Query": {
"Name": "RangeQuery",
"Query": {
"FieldName": "col_long",
"From": 1,
"To": 100,
"IncludeLower": true,
"IncludeUpper": false
}
}
}
使用SDK
您可以通过Java SDK、Go SDK、Python SDK、Node.js SDK、.NET SDK和PHP SDK使用范围查询。此处以Java SDK为例介绍范围查询的使用。
以下示例查询 Long 类型的 price 字段值处于左闭右开区间 [100, 500) 内的数据,返回最多 10 行数据及匹配总行数。
String tableName = "example_table";
String indexName = "example_index";
RangeQuery rangeQuery = new RangeQuery();
rangeQuery.setFieldName("price");
rangeQuery.greaterThanOrEqual(ColumnValue.fromLong(100L));
rangeQuery.lessThan(ColumnValue.fromLong(500L));
SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(rangeQuery);
searchQuery.setLimit(10);
searchQuery.setTrackTotalCount(SearchQuery.TRACK_TOTAL_COUNT);
SearchRequest request = new SearchRequest(tableName, indexName, searchQuery);
SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
columnsToGet.setReturnAll(true);
request.setColumnsToGet(columnsToGet);
SearchResponse response = client.search(request);
System.out.println(response.getTotalCount());
System.out.println(response.getRows());
计费说明
使用 VCU 模式(原预留模式)时,使用多元索引查询数据会消耗 VCU 的计算资源。使用 CU 模式(原按量模式)时,使用多元索引查询数据会消耗读吞吐量。更多信息,请参见多元索引计量计费。