用途:为编写与优化 Azure Cosmos DB 查询提供最佳实践指引,适合在编写或优化查询、实现分页、在点读取与查询间做选择、降低读取操作 RU 消耗、处理聚合与排序时参考。
主要能力(规则清单): query-point-reads:已知 id 和分区键时使用点读取。 query-aggregate-single-pass:用一次作用域内聚合查询计算 min/max/avg。 query-avoid-cross-partition:尽量减少跨分区查询。 query-use-projections:仅投影所需字段。 query-pagination:使用延续令牌实现分页。 query-avoid-scans:避免全容器扫描。 query-parameterize:使用参数化查询。 query-order-filters:按选择率排列过滤器顺序。 query-top-literal:TOP 使用字面整数。 query-latest-by-timestamp:用 ORDER BY 与 TOP 1 查询最新文档。 query-olap-detection:检测并重定向分析型查询。 query-distinct-keyword:正确使用 DISTINCT 关键字。
使用方式:在需要时引用上述指南;完整展开的规则见 AGENTS.md。资料未提供具体代码示例、安装命令、配置步骤、收费信息或平台要求,暂未提供。
适用场景:编写或优化 Cosmos DB 查询、实现分页、选择点读取而非查询、降低读取 RU、处理聚合与排序。
限制:仅为规则与最佳实践清单,资料未给出示例语句、性能数据、价格或版本兼容信息,缺失事实暂未提供。