Azure Cosmos DB Windows（本地）模拟器的发行说明

  • 项目

Azure Cosmos DB 模拟器会定期更新，其发行说明已在本文中提供。

下载最新版本 (2.14.16)

支持的版本

仅主动支持最新版本的 Azure Cosmos DB 模拟器。

最新版本 2.14.16

发布日期：2024 年 1 月 24 日

  • 此版本修复了导致仿真器即使在传递 /AllowNetworkAccess 命令行选项后仍然与 loopback 绑定，而非 public interface 的问题。

以前的版本

警告

产品组不支持模拟器的早期版本。

2.14.122023 年 3 月 20 日）

  • 此版本修复了影响 Gremlin 和表终结点 API 类型的问题。 在进行此修复之前，客户端应用程序在尝试连接到公共模拟器的终结点时会失败并显示 500 状态代码。

2.14.11（2023 年 1 月 27 日）

  • 此版本更新了 Azure Cosmos 模拟器后台服务，以匹配 Azure Cosmos DB 的最新联机功能。

2.14.9（2022 年 7 月 7 日）

  • 此版本更新了 Azure Cosmos 模拟器后台服务，以匹配 Azure Cosmos DB 的最新联机功能。

2.14.8

  • 此版本更新了 Azure Cosmos 模拟器后台服务，以匹配 Azure Cosmos DB 的最新联机功能。

2.14.7（2022 年 5 月 9 日）

  • 此版本更新了 Azure Cosmos 模拟器后台服务，以匹配 Azure Cosmos DB 的最新联机功能。 除了此更新之外，此版本还解决了几个问题：
    • 将数据资源管理器更新到最新内容，并修正快速入门示例文档的失效链接。
    • 通过在 Docker 容器中设置环境变量 (AZURE_COSMOS_EMULATOR_ENABLE_MONGODB_ENDPOINT) 添加了用于为 Linux Azure Cosmos DB 模拟器启用 API for MongoDB 和配置版本的选项。 有效设置如下：3.2、3.6、4.0 和 4.2

2.14.6（2022 年 3 月 7 日）

  • 此版本更新了 Azure Cosmos 模拟器后台服务，以匹配 Azure Cosmos DB 的最新联机功能。 除了此更新之外，此版本还解决了几个问题：
    • 修复了与仿真器运行时 CPU 使用率过高相关的问题。
    • 添加了 PowerShell 选项来设置 API for MongoDB 版本：-MongoApiVersion。 有效设置如下：3.2、3.6 和 4.0

2.14.5（2022 年 1 月 18 日）

  • 此版本更新了 Azure Cosmos 模拟器后台服务，以匹配 Azure Cosmos DB 的最新联机功能。 此版本的另一项重要更新是减少后台执行的服务数量，并根据需要启动这些服务。

2.14.4（2021 年 10 月 25 日）

  • 此版本更新了 Azure Cosmos 模拟器后台服务，以匹配 Azure Cosmos DB 的最新联机功能。

2.14.3（2021 年 9 月 8 日）

  • 此版本更新了 Azure Cosmos 模拟器后台服务，以匹配 Azure Cosmos DB 的最新联机功能。 还解决了收集的性能数据问题，并重置了 Linux Azure Cosmos DB 模拟器 Docker 映像的基础映像。

2.14.2（2021 年 8 月 12 日）

  • 此版本将本地数据资源管理器内容更新到了最新 Azure 版本，并重置了 Linux Azure Cosmos DB 模拟器 Docker 映像的基础映像。

2.14.1（2021 年 6 月 18 日）

  • 此版本改进了模拟器的启动时间，同时减少了其数据在磁盘上的占用量。 使用 /EnablePreview 参数激活了此新优化。

2.14.0（2021 年 6 月 15 日）

  • 此版本将本地数据资源管理器内容更新到 Azure 最新版本。 还修复了使用 JSON 文件上传功能导入多个项时出现的问题。

2.11.13（2021 年 4 月 21 日）

  • 此发布版本将本地数据资源管理器内容更新到 Azure 最新版本，并新增了 MongoDB 终结点配置 4.0。

2.11.11（2021 年 2 月 22 日）

  • 此版本将本地数据资源管理器内容更新到 Azure 最新版本。

2.11.10（2021 年 1 月 5 日）

  • 此版本将本地数据资源管理器内容更新到 Azure 最新版本。 还添加了一个新的公共选项 /ExportPemCert，模拟器用户能够通过此选项直接将公共模拟器的证书导出为 .PEM 文件。

2.11.9（2020 年 12 月 3 日）

  • 此版本更新了 Azure Cosmos 模拟器后台服务，以匹配 Azure Cosmos DB 的最新联机功能。 它还解决了 Azure Cosmos DB 模拟器功能的几个问题：
    • 解决在使用直接模式和 Java 客户端应用程序时大型文档有效负载请求会失败的问题。
    • 解决在由基于 .NET 的应用程序面向时 MongoDB 终结点版本 3.6 出现的连接性问题。

2.11.8（2020 年 11 月 6 日）

  • 此版本包含 Azure Cosmos DB 模拟器数据资源管理器的更新，并修复了“传输层安全性 (TLS) 1.3”客户端尝试打开数据资源管理器的问题。

2.11.6（2020 年 10 月 6 日）

  • 此版本解决了同时创建多个容器时与并发相关的问题。 此问题可能会使模拟器处于损坏状态，将来对模拟器的终结点发出的 API 请求会失败并出现“服务不可用”错误。 解决方法是停止模拟器，重置模拟器的本地数据，然后重启。

2.11.5（2020 年 8 月 23 日）

  • 此版本添加了两个新的 Azure Cosmos DB 模拟器启动选项：
    • /EnablePreview - 启用 Azure Cosmos DB 模拟器的预览功能。 预览功能仍在开发中，可通过 CI 和示例编写获取。
    • /EnableAadAuthentication - 支持模拟器接受自定义 Microsoft Entra ID 令牌作为 Azure Cosmos DB 主键的替代项。 此功能仍处于开发阶段；当前不支持特定的角色分配和其他与权限相关的设置。

2.11.2（2020 年 7 月 7 日）

  • 此版本更改了 Azure Cosmos DB 模拟器收集跟踪的方式。 Windows 性能运行时 (WPR) 现在是默认工具，用于捕获基于日志跟踪事件的跟踪，同时弃用基于 logman 的捕获。 在应用最新的 Windows 安全更新后，LOGMAN 在通过 Azure Cosmos DB 模拟器执行时不再按预期方式工作。

2.11.1（2020 年 6 月 10 日）

  • 此版本修复了与 Azure Cosmos DB 模拟器数据资源管理器相关的几个 bug：
    • 托管在某些 Web 浏览器版本中时，数据资源管理器无法连接到 Azure Cosmos DB 模拟器终结点。 模拟器用户可能无法通过网页创建数据库或容器。
    • 解决了导致模拟器用户无法使用数据资源管理器上传操作从 JSON 文件创建项的 bug。

2.11.0

  • 此版本引入了对自动缩放预配吞吐量的支持。 新增的功能包括：用于以请求单位（RU/秒）设置自定义的最大预配吞吐量级别的选项，在现有数据库和容器上启用自动缩放，以及通过 Azure Cosmos DB SDK 提供 API 支持。
  • 修复了查询大量文档（超过 1 GB）时模拟器会失败并出现内部错误状态代码 500 的问题。

2.9.2

  • 此版本修复了实现对 MongoDb 终结点版本 3.2 的支持时的一个 bug。 它还增加了对使用 Windows Performance Recorder (WPR) 而不是 logman 生成跟踪消息以进行故障排除的支持。

2.9.1

  • 此版本修复了查询 API 支持中的几个问题，并恢复了与旧版操作系统（例如 Windows Server 2012）的兼容性。

2.9.0

  • 此版本添加了用于将一致性设置为一致前缀并提高用户和权限的最大限制的选项。

2.7.2

  • 此版本为 Azure Cosmos DB 模拟器添加了 MongoDB 版本 3.6 服务器支持。 若要启动针对 3.6 版服务的 MongoDB 终结点，请使用“/EnableMongoDBEndpoint=3.6”选项从管理员命令行启动模拟器。

2.7.0

  • 此版本修复了 Azure Cosmos DB 模拟器中阻止用户执行 SQL 相关查询的回归问题。 此问题会影响配置了 API for NoSQL 终结点并正在使用基于 .NET Core 或 x86 .NET 的客户端应用程序的模拟器用户。

2.4.6

  • 此版本提供与截至 2019 年 7 月的 Azure Cosmos DB 服务中的功能相同的功能，所述例外情况除外。 它还修复了与通过命令行调用时模拟器关闭相关的几个 bug，以及使用直接模式连接的 SDK 客户端的内部 IP 地址覆盖。

2.4.3

  • MongoDB 服务默认情况下不再启动。 默认情况下，模拟器启用 SQL 终结点。 用户必须使用模拟器的 /EnableMongoDbEndpoint 命令行选项手动启动终结点。 现在，它就像所有其他服务终结点（例如 Gremlin、Cassandra 和表）一样。
  • 修复了使用“/AllowNetworkAccess”启动时模拟器中的 bug，即 Gremlin、Cassandra 和表终结点无法正确处理外部客户端发出的请求。
  • 将直接连接端口添加到“防火墙规则”设置。

2.4.0

  • 修复了当主计算机上存在网络监视应用（如 Pulse Client）时模拟器无法启动的问题。

后续步骤