Cosmos SDK 3.0 中文档DB SDK 2.x PopulateQueryMetrics等效项查询
Azure Cosmos DB .NET SDK 3.x 中 PopulateQueryMetrics 的等效配置
版本适配说明
SDK 从 2.x 迭代到 3.x 时重构了请求配置体系,和你提到的2.x用法的对应关系非常直接:
- 原2.x中用于查询配置的
FeedOptions类,在3.x中按场景拆分:查询相关的所有配置统一收敛到独立的QueryRequestOptions类中,不再和其他通用Feed配置混用。 - 原
FeedOptions.PopulateQueryMetrics开启查询指标统计的能力,直接以同名属性迁移到QueryRequestOptions类下,将该属性设置为true即可1:1等效实现原功能。 - 原2.x中需要手动配置的
EnableCrossPartitionQuery = true跨分区查询开关,在3.x中已彻底移除手动配置项:只要查询未指定固定分区键值,SDK会自动完成跨分区查询路由,无需额外设置。
等效实现代码
对应2.x版本创建动态类型查询、开启跨分区访问、启用指标统计的典型场景,3.x版本的标准实现代码如下:
// 获取目标容器实例 Container container = cosmosClient.GetContainer(databaseName, containerName); // 定义查询逻辑 QueryDefinition queryDefinition = new QueryDefinition("SELECT * FROM c WHERE c.age > 18"); // 配置查询参数 QueryRequestOptions requestOptions = new QueryRequestOptions { // 等效于2.x中FeedOptions.PopulateQueryMetrics = true PopulateQueryMetrics = true }; // 构建查询迭代器 FeedIterator<dynamic> queryIterator = container.GetItemQueryIterator<dynamic>( queryDefinition: queryDefinition, requestOptions: requestOptions );
查询执行完成后,可从返回的响应头中读取完整的查询执行指标,能力和2.x版本完全对齐。
内容的提问来源于stack exchange,提问作者isao
相关产品推荐
相关产品推荐

