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

项目
10/07/2024

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

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

重要

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

源或目标帐户启用了专用终结点时的迁移。
基于 RU 的 Azure Cosmos DB for MongoDB 在线和离线迁移。

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

先决条件

现有基于 vCore 的 Azure Cosmos DB for MongoDB 帐户。
- 如果没有 Azure 订阅，请免费创建一个帐户。
Azure Data Studio 的最新版本。
运行版本 3.2 或更高版本的 MongoDB。
将防火墙例外添加到源 MongoDB 帐户和基于 vCore 的 Azure Cosmos DB for MongoDB 目标帐户，以接受来自全局 Azure 数据中心的连接。
如果你是首次使用数据库迁移服务，请确保在订阅中注册了 Microsoft.DataMigration资源提供程序。

准备

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

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

在订阅中注册 Microsoft.DataMigration 资源提供程序

若要确保在订阅中注册 Microsoft.DataMigration 资源提供程序，可以按照下面的步骤进行操作：

Azure 门户：

转到 Azure 门户，导航到你的订阅。
在左侧菜单中，选择“设置”下的“资源提供程序”。
在顶部的搜索框中搜索 Microsoft.DataMigration。
如果未注册，请选择它，然后单击“注册”按钮。

Azure CLI：

打开 Azure Cloud Shell 或本地终端。
运行以下命令，注册资源提供程序：

az provider register --namespace Microsoft.DataMigration

PowerShell：

打开 Azure Cloud Shell 或本地 PowerShell。
运行以下命令，注册资源提供程序：

Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"

安装扩展

在开始迁移之前，先在 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 实例迁移到基于 vCore 的 Azure Cosmos DB for MongoDB 目标帐户。

在评估报告屏幕上，选择计划迁移的数据库。然后选择下一步。
按订阅和资源组依次进行筛选，缩小列表范围，以便选择目标 Azure Cosmos DB for MongoDB 帐户。然后提供连接到该帐户所需的连接凭证。
选择“测试连接”以验证 Azure Cosmos DB for MongoDB 帐户的凭据。选择“下一步”，到达将集合从源映射到目标的页面。
为映射列表中的每个集合选择“跳过”或“迁移”。目标中已存在的集合会自动用图标标记，并默认设置为“跳过”。选择“下一步”，配置 Azure 数据库迁移服务 (DMS)。

警告

选择“迁移”现有集合会覆盖整个集合，导致数据丢失且不可恢复。请谨慎选择此选项。
从下拉列表中选择现有的 Azure 数据库迁移服务实例，或选择“新建”以创建新的迁移服务。 Azure 数据库迁移服务可以将数据移入和移出 Azure 数据平台，它采用云基础结构（而非依赖本地资源）进行数据传输。
选择最适合用例的迁移模式。
- 在线迁移会复制集合数据，确保在此过程中也会复制更新。此方法的优势在于停机时间极端，有利于确保持续运行以实现业务连续性。如果正在进行的操作至关重要，需要优先考虑减少停机时间，则可以使用此选项。
- 离线迁移会首先捕获数据库的快照，提供更简单且可预测的方法。如果可以接受使用数据库的静态副本，实时更新并不重要，则可以使用这种方法。
选择“下一步”可查看迁移摘要。查看并确认摘要中的详细信息，然后选择“创建架构”以在目标帐户上创建资源。
选择“开始迁移”以使用所选迁移服务启动数据传输。
在“确认设置”弹出窗口中，验证防火墙设置是否符合要求。选择确定以确认。