用途:为 Azure Cosmos DB 的数据设计与查询提供最佳实践规则集,适用于设计文档、选择分区键、定义索引策略,以及编写和优化查询时参考。
主要能力分为五类。数据建模:保持项远低于 2MB 限制、读多写少场景反规范化、嵌入一同读取的数据、遵守 ID 长度与字符约束、正确处理 JSON 序列化、嵌套不超过 128 层、理解 IEEE 754 数值精度限制、数据变大时改用引用、用 ID 引用加临时水合表达关系、对文档架构做版本管理、用类型判别器处理多态数据。分区键设计:规划 20GB 逻辑分区上限、分散写入避免热分区、使用分层分区键、选高基数分区键、选不可变属性、遵守分区键值长度限制、使分区键与查询模式对齐、必要时创建合成分区键。索引策略:复合索引方向须匹配 ORDER BY、用复合索引支持 ORDER BY、排除未用索引路径、理解索引模式、使用正确的索引路径语法、选择合适的索引类型、为地理查询添加空间索引。查询优化:用单次限定聚合算 min/max/avg、减少跨分区查询、避免全容器扫描、用 DISTINCT 去重、用显式 ORDER BY 加 TOP 1 取最新文档、识别并把分析型查询移出事务容器、按选择性排列筛选器、用延续令牌分页、使用参数化查询、已知 ID 与分区键时用点读取、安全参数化 TOP 值、仅投影所需字段。设计模式:用变更源构建物化视图优化跨分区查询、用计数或缓存排名替代全分区扫描、用服务层在渲染前水合文档引用。
使用方式:在涉及上述场景时参照这些规则。资料未提供具体安装命令、代码示例或调用接口,暂未提供。
限制与适用边界:内容为设计指导规则,非可执行工具;每条规则的详细适用条件与例外未在资料中展开。