Azure DocumentDB 发行说明

Azure DocumentDB 持续发展，不断推出新功能、提升性能并增强基础设施。本文提供了 Azure DocumentDB 的功能版本、引擎更新和服务改进的综合历史记录。每个版本都包含有关新功能、查询操作员增强功能和基础结构更改的详细信息，以帮助你随时了解最新开发。

注释

标记为 [预览] 的项目需要支持请求才能在群集上启用它们。

Latest

重要

Azure Cosmos DB for MongoDB（vCore）现在是 Azure DocumentDB（与 MongoDB 兼容性），由开源 DocumentDB 项目提供支持。

本 2025 年 11 月 18 日版本将服务从 Azure Cosmos DB for MongoDB（vCore） 重命名为 Azure DocumentDB ，以及其他功能更改。

“增强功能”

Visual Studio Code 中的索引顾问功能：索引优化、性能见解和查询优化的内置指南。有关详细信息，请参阅索引顾问功能。
适用于 Visual Studio Code 的 MongoDB 迁移扩展：适用于各种工作负荷的端到端联机迁移体验。有关详细信息，请参阅使用 Visual Studio Code 扩展进行迁移。
[预览] 高级 SSD v2 支持：下一代存储提供更好的性能，无需额外付费。有关详细信息，请参阅高性能存储。
预留实例支持：在一年或三年内节省成本。
Azure Cosmos DB for MongoDB 到 Azure DocumentDB 迁移：用户从 Azure Cosmos DB for MongoDB 迁移到 Azure DocumentDB 的集成路径。

2025 年 10 月 10 日

本次2025 年 10 月 10发布引入了架构验证，增强了 TTL 索引性能。同时，客户管理密钥和 Microsoft Entra ID 身份验证已全面上线。

引擎改进（1017）

[预览] 添加对在_id字段上筛选的排序查询的索引下推支持。
[预览] 在创建或修改规则期间添加 $jsonSchema 架构验证支持。
[预览] 集成 CSFLE（客户端字段级别加密）以添加模式约束。
[预览] TTL（生存时间）索引通过索引提示实现有序索引扫描。 TTL 索引连续执行批量删除任务，持续时间最长可达 60 秒，而不是每 60 秒执行一次。

基础设施改进（1017）

包含来自 API 版本 2025-09-01 的功能：
- 数据 API
- Microsoft Entra ID 身份验证
- 能够禁用本机身份验证。
- 客户管理的密钥（CMK）

2025 年 8 月 29 日

此版本侧重于使用索引提示、增强的命令和聚合运算符的 bug 修复来改进查询性能。

引擎增强功能（0829）

引入了对索引提示的支持。此功能允许在查询执行期间显式指定索引。
[预览] 对已排序索引启用索引扫描，以便对计数查询执行仅索引扫描，其中筛选器可以向下推送到索引，并且不应用投影。
[预览] 改进了并行索引生成性能。
改进了点查找查询以提高执行效率。
增强usersInfo和connectionStatus命令可返回所有受支持的角色（ReadWrite、、）UserAdmin和特权集（Root、dbAdmin、userAdmin、clusterMonitorclusterManager、hostManager）。
通过引入用于插入作的自定义规划器来提高查询规划性能。
修复 $lastN 和 $bottomN 中的 bug。
修复了响应类型的更新，以向需要 32 位响应的C++驱动程序添加兼容性。
增强了输出阶段 $merge 和 $out 的错误消息。

基础设施改进（0909）

Microsoft Entra ID 支持全面可用。

2025 年 7 月 15 日

此版本为 M30 层提供索引优化改进、HNSW 索引支持以及增强的 TTL 索引行为以提高性能。

引擎优化和增强（0715）

[预览] 启用了任何字段上的索引下推优化策略 $sort 。
为 $limit 启用了索引下推优化。
[预览] 添加了对筛选条件的复合索引的支持。
为 M30 群集层添加了对分层可导航小世界（HNSW）索引的支持。
增强了 TTL 索引行为，即使群集由于磁盘已满而变为只读，也会继续处理。
改进了并行生成，以便更快地在分片和未分片集合上创建索引。

基础设施改进（0730）

[预览] 添加了对 CMK 的支持，仅在预配阶段才允许。

2025 年 5 月 5 日

此版本包括具有增强数据类型转换、改进排名运算符和管道验证改进的 v8 引擎。

v8 已发布。
- 支持 $convert binData 到 binData、string 到 binData 和 binData 到字符串（格式除外：auto）。
- 添加了对 $toUUID 简化字符串到 UUID 转换的支持。
- 现在，$rank 和 $denseRank 在计算排名时将 null 和缺失值视作相同，这与 $sort 的行为保持一致。
- 管道大小限制 - 如果超出管道阶段限制，聚合会抛出错误。
- $getField 现在接受解析为字符串的任何有效表达式，而不仅仅是字符串常量。

基础设施改进（0520）

[预览]Microsoft Entra ID 支持。

2025 年 3 月 23 日

引擎强化（0323）

添加了对 listDatabases 命令的支持。
添加了对类型聚合运算符 $toUUID的支持。
对谓词筛选器部分下推$in 的支持已添加。
添加了对 $dateFromString 运算符的完整功能支持。
聚合运算符的 $getField 扩展语法。现在，“field”的值可以是解析为字符串的表达式。
添加了对顶级聚合命令行变量（cmdlet）的支持，在$geoNear阶段。
后端命令现在支持语句超时。
引入了对 $toUUID 聚合运算符的支持。
实现了 $dateFromString 运算符的完整功能。
将$getField运算符扩展为接受解析成字符串的字段参数表达式。
对聚合阶段的扩展排序规则支持：$project、$redact、$set、$addFields、$replaceRoot。
启用了带有比较运算符（$expr、$in、$cmp、$eq、$ne、$lt、$lte、$gt、$gte）的排序支持。
启用了对使用新运算符类的唯一索引截断的默认支持。
引入了对聚合（$setEquals、$setUnion、$setIntersection、$setDifference、$setIsSubset）中的集合运算符的排序规则支持。

2025 年 2 月 12 日

此版本引入了开源的 PostgreSQL 17 构建、优化聚合性能，以及具有异地副本提升支持的自动缩放的正式发布。

引擎优化 (0212)

引入了面向 PostgreSQL 17 的 pg_documentdb 开源版本。
添加了对将 $graphLookup 递归通用表表达式（CTE） JOIN 筛选器推送到索引的支持，从而提高了查询效率。
已启用对以下聚合阶段和命令的支持： currentOp、 collStats、 dbStats和 indexStats。
通过在启用$lookup时允许$unwind内联来改善preserveNullAndEmptyArrays的性能。
在表达式为常量时，通过跳过文档加载来优化聚合。

基础结构增强（0212）

Autoscale 已正式发布。
[预览]更改 Kafka Debezium 连接器和 Pymongo 驱动程序的流支持。
已启用异地副本升级。
扩展了区域可用性。
- Switzerland West
- Jio India West

2025 年 1 月 23 日

此版本标志着 Azure DocumentDB 引擎开源版本的一个重要里程碑。

我们开源了 Azure DocumentDB 后面的引擎！有关详细信息，请参阅 https://github.com/documentdb。

2024 年 10 月 14 日

此版本默认启用后台索引生成、扩展 $setWindowFields 功能，并添加对 $fill 聚合阶段的支持。

默认情况下，索引构建在后台运行。
支持使用 $setWindowFields. 的更多选项。
- $integral。
- $derivative。
- $expMovingAvg。
- $linearFill。
- $locf。
- $documentNumber。
- $shift。
- 添加了对更多运算符 $group的支持。
  - $top、$topN、$bottom、$bottomN、$first、$firstN、$last、$lastN、$maxN、$minN。
- $max。
- $min。
添加了对聚合运算符的支持。
- $toHashedIndexKey。
添加了对聚合阶段的支持。
- $fill。
添加了对 ChangeStreams 的 wallTime 支持。

2024 年 9 月 16 日

ChangeStream 的封闭预览版。
运行时支持 $find / $aggregate 查询的排序规则受限预览版。
启用大型索引键作为索引的默认选项。
添加了对$DbRef及更多字段$ref/$id/$db的支持，并对elemMatch的选项进行了限制。
添加了对三角聚合运算符的支持。
支持使用 $setWindowFields. 的更多选项。
- $count。
- $addToSet。
- $push。
- $avg。
- $rank。
- $denseRank。
- $covariancePop
- $covarianceSamp
支持使用 $let 的以下功能。
- $lookup。
- $find。
- $aggregate。
支持 $merge 以下聚合阶段。
- whenMatched： replace / keepExisting / merge / fail.
- 条件不匹配时：insert / discard / fail.

2024 年 8 月 5 日

地理空间支持现已正式发布。
v7 已发布。
支持使用 TLS1.3 进行 mongo 连接。
支持累加器
- $mergeObjects。
支持聚合运算符
- $bitAnd。
- $bitOr。
- $bitXor。
- $bitNot。
- $let。
支持聚合阶段
- $bucket。
- $vectorSearch。
- $setWindowFields （仅使用 $sum 窗口累加器）。
地理空间查询运算符
- $minDistance。
- $maxDistance。
- $near。
- $nearSphere。

2024 年 7 月 2 日

此版本添加了新的客户活动和请求指标，以及对地理空间操作员和累积器增强功能的预览支持。

添加了指标
- 客户活动.
- 请求。
[预览] 对累加器的支持
- $mergeObjects。
[预览] 支持聚合运算符
- $let。
[预览] 地理空间查询运算符
- $minDistance。
- $maxDistance。

2024 年 5 月 6 日

此版本引入了地理空间聚合、大型索引键支持、地理副本，以及组和去重操作的性能改进。

查询运算符增强功能。
- $geoNear 聚合。可以通过标志位Geospatial support启用聚合阶段
- 支持累加器
  - $push。
  - $addToSet。
  - $tsSecond / $tsIncrement.
  - $map / $reduce.
- 支持日期表达式
  - $dateAdd。
  - $dateSubtract。
  - $dateDiff。
- 支持聚合运算符
  - $maxN / $minN.
  - $sortArray。
  - $zip。
使用大型索引键创建索引：大于 2.7 KB 的值。
支持跨区域灾难恢复和读取缩放的异地副本。
改进了分组和去重的性能。
改进了 $geoWithin 半径大于π时查询 $centerSphere 的性能。

2024 年 4 月 16 日

此版本增加了 $graphLookup 对存在检查、范围查询和索引扫描的支持和显著性能改进。

查询运算符增强功能。
- $centerSphere 带有索引下推以及对 GeoJSON 坐标的支持。
- $graphLookup 支持。
性能得到了改进。
- $exists，{ $eq: null }{ $ne: null }通过添加新索引词。
- 在$in/$nq/$ne索引中使用扫描。
- 比较部分（范围）查询。

2024 年 3 月 18 日

此版本增加了对专用终结点的门户支持、M40+ 层级的 HNSW 矢量索引支持，以及支持后台索引构建的地理空间查询预览。

在门户上启用专用终结点支持。
[预览] 启用地理空间查询。
查询运算符增强功能。
- $centerSphere 使用索引下推。
- $min 和 $max 运算符配合 $project 使用。
- $binarySize 聚合运算符。
[预览] 能够在后台生成索引（唯一索引除外）。

2024 年 3 月 3 日

此版本包含对 Explain 计划和各种矢量筛选功能的增强。

允许在执行矢量搜索时按元数据列进行筛选。

Explain 计划提供两种不同的模式

	Description
`allShardsQueryPlan`	此模式是一种新的说明模式，用于查看查询执行中涉及的所有分片的查询计划。此模式提供分布式查询的综合视角。
`allShardsExecution`	此模式提供了一种替代说明模式，用于检查查询中涉及的所有分片的执行详细信息。此模式提供用于性能优化的综合信息。

更多区域提供免费层支持。
在后台生成索引的功能现在以预览版提供。

针对 Azure DocumentDB 的 Azure 更新

Last updated on 2025-12-11

通过