适用于 Azure Data Studio 的 Azure Cosmos DB for MongoDB vCore 迁移扩展（预览版）

项目
04/22/2024

Azure Cosmos DB for MongoDB 迁移扩展可帮助将 MongoDB 工作负载迁移到 Azure Cosmos DB。可以使用此扩展执行以下操作：

运行端到端评估，并找出将工作负载迁移到 Azure Cosmos DB for MongoDB vCore 可能需要执行的操作。
使用所选数据库和集合执行操作，迁移到 Azure Cosmos DB for MongoDB vCore。

重要

目前此扩展不支持以下场景：

Azure Cosmos DB for MongoDB vCore 的在线迁移。
Azure Cosmos DB for MongoDB RU 的在线和离线迁移。

有关 API for MongoDB vCore 的备用解决方案的详细信息，请参阅迁移选项。

先决条件

现有的 Azure Cosmos DB for MongoDB vCore 帐户。
- 如果没有 Azure 订阅，请免费创建一个帐户。
Azure Data Studio 的最新版本。
运行版本 3.2 或更高版本的 MongoDB。

准备

开始实际迁移数据前，提前制定迁移规划和决策。

有关 API for MongoDB vCore 预迁移规划的详细信息，请参阅 Azure Cosmos DB for MongoDB vCore 的预迁移步骤。
有关 API for MongoDB RU 预迁移规划的详细信息，请参阅 Azure Cosmos DB for MongoDB RU 的预迁移步骤。

安装扩展

在开始迁移之前，先在 Azure Data Studio 中安装 Azure Cosmos DB for MongoDB 迁移扩展。

在 Azure Data Studio 中打开扩展管理器。可以选择扩展图标，也可以在“视图”菜单中选择“扩展”。
在搜索栏中输入 Cosmos。
选择“Azure Cosmos DB Migration for MongoDB”扩展并查看其详细信息。
选择“安装” 。

配置扩展设置

安装扩展后，可以配置一些扩展设置。此步骤是可选的。如果未显式配置任何设置，则扩展将使用默认设置。

转到扩展并选择“Azure Cosmos DB Migration for MongoDB”，选择“管理设置”图标，然后选择“扩展设置”。
在此扩展的扩展设置下，提供 Assessment path 以更改评估元数据的存储位置。如果留空，则会使用默认位置。

连接 MongoDB 源

首次使用扩展连接到现有的 MongoDB“源”实例。开始本部分的操作前，请确保已准备好源的连接凭据。

在菜单栏中转到连接图标，选择“新建连接”。

在“连接”窗格中填写以下字段：

	值
连接类型	`Azure Cosmos DB for MongoDB`
连接字符串/参数	使用现有源 MongoDB 实例的连接字符串或参数。
服务器组	`Default`
名称(可选)	提供此连接的唯一名称。

选择“连接” 。
在“连接”窗格中打开新建连接的“上下文菜单”。然后选择“管理”。
选择 Azure Cosmos DB 迁移。

运行评估

评估会检查当前的 MongoDB 数据资产和利用率。然后，评估功能会生成一份全面报告，协助确定将工作负荷迁移到 Azure Cosmos DB for MongoDB 之前要采取的必要操作。

前往“仪表板”选项卡。然后选择“评估和迁移数据库”。
完成向导以向扩展提供详细信息，以便扩展可以执行评估。
1. 在“评估名称”字段中输入标题。
2. 在“产品/服务”下拉列表中选择目标 Azure Cosmos DB for MongoDB 帐户。
3. 提供 MongoDB 日志的路径。
  
  提示
  
  这是一个可选字段，用于提供日志路径，可在集合级别生成更详细的见解。未指定日志文件夹时，此工具将依赖来自 serverStatus 命令的信息来执行评估。请注意，“serverStatus”命令仅会报告自上次服务器重启以来该功能的使用情况。要获取准确反映实际工作负载的评估，请确保自上次服务器重启以来已经过足够的时间。
4. 提供“数据评估日志”的路径。
  
  提示
  
  虽然此字段仍然是可选的，不过提供数据评估日志有助于更全面地洞察工作负载。通过扫描数据和检查详细日志来获取这些日志。数据评估将在启动迁移评估之前作为命令行接口 (CLI) 独立执行，然后在此处提供生成的 JSON。在此处下载数据评估 CLI。
5. 选择“运行验证”以验证评估输入内容。
验证成功后，选择“开始评估”即可运行评估。
评估需要几分钟时间，具体取决于源服务器的大小。等待评估完成，然后继续。
评估完成后，就可获得评估报告。
在评估报告中，选择相应实例名称即可查看服务器范围内的问题列表。选择相应数据库即可查看该数据库的问题。
选择“下载报告”即可获取可下载的合并报告。
研究评估报告，以确定在 Azure Cosmos DB for MongoDB 上无缝迁移工作负荷需要采取的操作。开始下一步之前，请确保评估中报告的所有阻塞性问题都已解决。如果存在未解决的问题，可以退出该流程，稍后再处理这些问题。问题解决后，返回并重启评估和迁移流程。

执行离线迁移

现在，使用评估报告将数据从源 MongoDB 实例离线迁移到目标 Azure Cosmos DB for MongoDB vCore 帐户。

在评估报告屏幕上，选择计划迁移的数据库。然后选择下一步。
按订阅和资源组依次进行筛选，缩小列表范围，以便选择目标 Azure Cosmos DB for MongoDB 帐户。然后提供连接到帐户所需的连接凭据。
选择“测试连接”以验证 Azure Cosmos DB for MongoDB 帐户的凭据。选择“下一步”，到达将集合从源映射到目标的页面。
重要

目前，该扩展不支持启用专用终结点的源或目标 MongoDB 实例。
- 将源 MongoDB 实例配置为允许来自全局 Azure 数据中心的连接。
- 将防火墙例外添加到 Azure Cosmos DB for MongoDB vCore 目标帐户，以允许来自全局 Azure 数据中心的连接。
- 要查找相关 IP 范围信息，请从全局 Azure IP 地址范围下载 JSON 并查找该 JSON 文件的“AzureCloud.{目标 Cosmos DB 帐户区域}”。
为映射列表中的每个集合选择“跳过”或“迁移”。目标中已存在的集合会自动用图标标记，并默认设置为“跳过”。选择“下一步”，配置 Azure 数据库迁移服务 (DMS)。

警告

选择“迁移”现有集合会覆盖整个集合，导致数据丢失且不可恢复。请谨慎选择此选项。
从下拉列表中选择现有的 Azure 数据库迁移服务实例，或选择“新建”以创建新的迁移服务。 Azure 数据库迁移服务可以将数据移入和移出 Azure 数据平台，它采用云基础结构（而非依赖本地资源）进行数据传输。

重要

如果你是首次使用数据库迁移服务，请确保在订阅中注册了 Microsoft.DataMigration资源提供程序。
选择“下一步”可查看迁移摘要。查看并确认摘要中的详细信息，然后选择“创建架构”以在目标帐户上创建资源。
选择“开始迁移”以使用所选迁移服务启动数据传输。
作业初始化后，就可在仪表板页上查看迁移状态。
在迁移列表中选择相应的迁移即可查看更多详细信息。等待迁移完成，然后继续。

注意

在远程异步执行迁移作业时，无需保持连接到迁移服务或 Azure Data Studio。迁移作业在迁移服务上执行，迁移状态会持续在仪表板上更新。

如果选择迁移的集合超过 50 个，迁移服务会将迁移作业分批成多个作业，每个批次作业最多包含 50 个集合。
作业完成后，迁移状态会显示为成功。