通过

升级 Azure Cosmos DB for MongoDB 帐户的 API 版本

  • 项目

适用对象： MongoDB

本文介绍如何升级 Azure Cosmos DB API for MongoDB 帐户的 API 版本。 升级后，可以使用 Azure Cosmos DB 的 MongoDB API 中的最新功能。 升级过程不会中断帐户的可用性，也不会在任何时候消耗 RU/s 或减少数据库的容量。 此过程不会影响现有数据或索引。

升级到新 API 版本时，在升级生产工作负载之前，先从开发/测试工作负载开始。 在升级 Azure Cosmos DB for MongoDB 帐户之前，必须先将客户端升级到与要升级到的 API 版本兼容的版本。

警告

目前，只有使用服务器版本 3.2 的符合条件的帐户可以升级到版本 3.6 和更高版本。 如果帐户未显示升级选项，请提交支持工单。

进行版本升级

  1. 登录到 Azure 门户。

  2. 导航到 Azure Cosmos DB for MongoDB 帐户。 打开“概述”窗格，验证当前的“服务器版本”是 3.2 还是 3.6。

    展示如何从 Azure 门户检查 MongoDB 帐户的当前版本的屏幕截图。

  3. 从左侧菜单中打开“Features”窗格。 此窗格显示可用于数据库帐户的帐户级功能。

  4. 选择 Upgrade MongoDB server version 行。 如果没有看到此选项，则表示你的帐户可能没有进行此升级的资格。 如果是这种情况，请提交支持工单。

    用于升级帐户的“功能”页面的屏幕截图。

  5. 查看显示的有关升级的信息。 选择“Set server version to 4.2”（或 4.0/3.6，具体取决于当前版本）。

    升级指南和所选升级选项的屏幕截图。

  6. 开始升级后，“功能”菜单会灰显，并且状态会设置为“挂起”。 升级大约需要 15 分钟才能完成。 此过程不会影响数据库帐户的现有功能或操作。 完成后，“更新 MongoDB 服务器版本”状态会显示升级后的版本。 如果处理请求时出现问题，请联系支持人员。

  7. 升级帐户后，需注意以下事项：

    1. 如果已从 3.2 升级，请回到“概述”窗格，复制要在应用程序中使用的新连接字符串。 运行 3.2 的旧连接字符串不会中断。 为确保获得一致的体验，所有应用程序都必须使用新的终结点。

    2. 如果从 3.6 升级，现有的连接字符串会升级到指定的版本，并且应继续使用。

进行版本降级

还可以通过升级版本部分中的相同步骤将帐户降级到 4.0 或 3.6。

  1. 如果在从 3.2 进行升级后希望降级回 3.2，请在主机 accountname.documents.azure.cn 中改回使用以前的 (3.2) 连接字符串，该字符串在升级后运行 3.2 版时仍处于活动状态。

  2. 更改应用程序中的连接字符串。

相关内容