前提条件
已初始化Client。具体操作,请参见初始化Tablestore Client。
已在数据表上创建多元索引。具体操作,请参见创建多元索引。
参数
|
参数 |
说明 |
|
tableName |
数据表名称。 |
|
indexName |
多元索引名称。 |
|
offset |
本次查询的起始位置。 |
|
limit |
本次查询返回的最大行数。 仅需获取总行数而不需要具体数据时,设置为 0。 |
|
query |
查询类型。全匹配查询设置为 |
|
getTotalCount |
是否返回匹配的总行数。默认值为 设置为 |
|
columnToGet |
每行匹配结果返回的列。通过
|
示例
以下示例通过全匹配查询统计数据表的总行数:
/**
* 通过全匹配查询统计数据表的总行数。
*/
client.search({
tableName: TABLE_NAME,
indexName: INDEX_NAME,
searchQuery: {
offset: 0,
limit: 10, // 仅需获取总行数时设置为 0,不返回具体数据。
query: {
queryType: TableStore.QueryType.MATCH_ALL_QUERY
},
getTotalCount: true // 设置为 true 返回匹配的总行数。默认值为 false。
},
columnToGet: { // RETURN_SPECIFIED:返回指定列;RETURN_ALL:返回所有列;RETURN_ALL_FROM_INDEX:返回多元索引中的所有列;RETURN_NONE:仅返回主键列。
returnType: TableStore.ColumnReturnType.RETURN_SPECIFIED,
returnNames: ["Col_1", "Col_2", "Col_3"]
}
}, function (err, data) {
if (err) {
console.log('error:', err);
return;
}
console.log('success:', JSON.stringify(data, null, 2));
});
常见问题
相关文档
多元索引查询类型包括精确查询、多词精确查询、全匹配查询、匹配查询、短语匹配查询、前缀查询、范围查询、通配符查询、多条件组合查询、地理位置查询、嵌套类型查询、向量检索和列存在性查询,您可以选择合适的查询类型进行多维度数据查询。
如果要对结果集进行排序或者翻页,您可以使用排序和翻页功能来实现。具体操作,请参见排序和翻页。
如果要按照某一列对结果集做折叠,使对应类型的数据在结果展示中只出现一次,您可以使用折叠(去重)功能来实现。具体操作,请参见折叠(去重)。
如果要进行数据分析,例如求最值、求和、统计行数等,您可以使用Search接口的统计聚合功能或者SQL查询来实现。具体操作,请参见统计聚合和SQL查询。
如果要快速导出数据,而不关心整个结果集的顺序时,您可以使用ParallelScan接口和ComputeSplits接口实现多并发导出数据。具体操作,请参见并发导出数据。