你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
升级 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 和更高版本。 如果帐户未显示升级选项，请提交支持工单。
进行版本升级
登录到 Azure 门户。
导航到 Azure Cosmos DB for MongoDB 帐户。 打开“概述”窗格，验证当前的“服务器版本”是 3.2 还是 3.6。
从左侧菜单中打开“
Features”窗格。 此窗格显示可用于数据库帐户的帐户级功能。选择
Upgrade MongoDB server version行。 如果没有看到此选项，则表示你的帐户可能没有进行此升级的资格。 如果是这种情况，请提交支持工单。
查看显示的有关升级的信息。 选择“
Set server version to 4.2”（或 4.0/3.6，具体取决于当前版本）。
开始升级后，“功能”菜单会灰显，并且状态会设置为“挂起”。 升级大约需要 15 分钟才能完成。 此过程不会影响数据库帐户的现有功能或操作。 完成后，“更新 MongoDB 服务器版本”状态会显示升级后的版本。 如果处理请求时出现问题，请联系支持人员。
升级帐户后，需注意以下事项：
如果已从 3.2 升级，请回到“概述”窗格，复制要在应用程序中使用的新连接字符串。 运行 3.2 的旧连接字符串不会中断。 为确保获得一致的体验，所有应用程序都必须使用新的终结点。
如果从 3.6 升级，现有的连接字符串会升级到指定的版本，并且应继续使用。
重要
从 3.2 版升级时，数据库帐户终结点后缀会更新为以下格式：<your_database_account_name>.mongo.cosmos.azure.com。 如果你的帐户是在主权云、政府云或受限制的 Azure 云中创建的，此终结点可能会略有不同。
如果是从 3.2 版升级，你需要替换应用程序以及驱动程序中连接此数据库帐户的现有终结点。 只有使用新终结点的连接才能访问新 API 版本中的功能。 上一个 3.2 终结点的后缀应为 .documents.azure.com。
从 3.2 升级到更高版本时，现在需要复合索引才能对多个字段执行排序操作，以确保这些查询的稳定、高性能。 确保创建这些复合索引，以便你的多字段排序成功。
进行版本降级
还可以通过升级版本部分中的相同步骤将帐户降级到 4.0 或 3.6。
如果在从 3.2 进行升级后希望降级回 3.2，请在主机
accountname.documents.azure.com中改回使用以前的 (3.2) 连接字符串，该字符串在升级后运行 3.2 版时仍处于活动状态。更改应用程序中的连接字符串。