评估 MongoDB 安装和计划迁移到 Azure DocumentDB

在将数据迁移到 Azure DocumentDB 之前,先执行前期规划任务并做出关键决策。 这些决策使迁移过程顺利运行。

先决条件

  • 运行 MongoDB 4.4.2 或更高版本的现有 MongoDB 安装。 评估不支持早期版本。

评估资源的兼容性和准备情况以供迁移

在规划迁移之前,请评估现有 MongoDB 资源的状态,以帮助规划迁移。 使用 VS Code 中的 Azure DocumentDB 迁移扩展来评估工作负荷的兼容性和就绪性,同时规划从 MongoDB 迁移到 Azure DocumentDB。 端到端评估,并找出您需要采取的步骤,以确保您的工作负载在 Azure Cosmos DB 上无缝运行。 评估报告在帐户、数据库和收集级别提供结果,每个结果都标记为“严重”、“警告”或“信息”,具体取决于严重性以帮助确定优先级。 报告包括:

  • 不支持的功能和语法:它标记不受支持的 MongoDB 功能、命令、查询语法和索引类型,其使用频率用于确定修复的优先级。

  • Resource-Specific 建议:每个发现都包含受影响的资源名称、可操作的建议以及修正的相关技术详细信息。

  • 环境概述:汇总源 MongoDB 环境的关键方面,例如数据库和集合的版本、许可证、实例类型和统计信息。

  • 兼容性和平台约束:详细Azure特定于 DocumentDB 的配额、限制以及分片工作负荷的潜在分片密钥不兼容。

进行评估

  1. 要开始,请在 VS Code 中安装 Azure DocumentDB 迁移扩展。 这会自动安装其必备组件 适用于 Visual Studio Code 的 DocumentDB 扩展。

  2. 从活动栏中打开 DocumentDB 。

  3. 添加要评估的 MongoDB 服务器以迁移到 文档数据库连接 列表。

  4. 展开所选连接,然后右键单击并选择 “数据迁移...”。 文档数据库连接中右键单击菜单的屏幕截图。

  5. 在命令面板中,选择迁移到 Azure DocumentDB。 命令面板的屏幕截图,其中列出了Visual Studio Code中的迁移工具。

  6. 然后选择 Azure DocumentDB 的迁移前评估。 命令面板的屏幕截图,其中显示了Visual Studio Code中的迁移前评估选项。

  7. 评估向导引导您完成三个步骤。 在 “开始验证 ”步骤中,选择“ 运行验证 ”以验证凭据、先决条件和连接,然后再继续作。 评估向导中“开始验证”步骤的屏幕截图。

    重要

    若要执行评估,连接的 MongoDB 用户必须具有在源实例上分配的 readAnyDatabase 和 clusterMonitor 角色。

  8. 在 “填写评估详细信息 ”步骤中,提供所需的输入: 评估向导中“填写评估详细信息”步骤的屏幕截图。

    • 在 “评估名称 ”字段中输入标题。
    • 从“产品/服务”下拉列表中选择 vCore。
    • 提供 MongoDB 日志的路径。

    小窍门

    虽然是可选的,但指定日志路径允许在集合级别进行更详细的发现。 如果省略,该工具依赖于命令中的数据 serverStatus ,该命令仅反映自上次重启以来的功能使用情况。 允许在上次服务器重启后经过足够的时间,以便进行准确的工作负荷评估。

    • 提供数据评估日志的路径。

    小窍门

    虽然是可选的,但提供数据评估日志可增强工作负荷见解。 这些日志是通过扫描数据和读取详细日志生成的。 在启动迁移评估之前,数据评估会独立作为 CLI 运行,并在此处使用生成的 JSON。 在此处下载数据评估 CLI。

  9. 选择 “开始评估 ”以开始评估过程。

  10. 在 “获取报表 ”步骤中,等待评估完成。 持续时间取决于源服务器的大小。 评估正在进行时评估向导中“获取报表”步骤的屏幕截图。

  11. 评估完成后,选择“ 下载报表 ”以检索 HTML 报表。 评估完成后评估向导中“获取报表”步骤的屏幕截图。

查看过去的评估

查看以前的评估可能很有价值。 使用 查看过去的评估选项卡可以access详细的历史报告。 评估列表包括在当前使用的计算机上针对所选连接启动的所有评估。

扩展中“查看过去评估”选项卡的屏幕截图。

FAQ

如果“运行验证”步骤失败,我该如何继续操作?

检查扩展中显示的错误消息以确定验证失败的原因。 常见问题包括无法连接到 MongoDB 终结点或连接服务器上的用户权限不足。

若要运行评估,请确保连接的 MongoDB 用户在源实例上分配有 readAnyDatabase 和 clusterMonitor 角色。

用于 grantRolesToUser 向当前用户分配必要的角色。

如何在“功能兼容性”评估中查看集合和数据库名称?

该 serverStatus 命令用于功能兼容性评估。 但是,此命令不提供数据库或集合名称,这会阻止扩展报告它们。

有关更详细的评估结果,请重新运行评估,并在 “日志文件夹路径” 字段中指定包含 MongoDB 日志的文件夹。

如何启用分析来检测跨集合管道依赖项?

性能分析是可选的。 如果已知道工作负荷的跨集合管道依赖项,则可以跳过此步骤。

该脚本需要支持数据库性能分析的源部署。 MongoDB Atlas M0(免费)和 Flex 群集不支持 setProfilingLevel。 对于不支持分析的部署,请跳过此可选步骤,通过查看应用程序的聚合管道来单独标识依赖项。 有关特定于层的限制,请参阅 Atlas 不支持的命令。

启用分析之前,请记录db.getProfilingStatus()每个数据库的现有设置,包括分析级别(was)、slowmssampleRate和任何filter设置。 如果存在,请使用 db.getCollection("system.profile").stats() 检查每个数据库的封顶 system.profile 集合的大小。 确保它有足够的容量来保留代表性工作负荷的管道条目,直到评估读取它们。 如果需要创建或调整集合大小,请按照 “管理数据库探查器”操作。

分析器可能会影响性能并记录敏感的查询数据。 管道筛选器还会影响慢查询诊断日志记录:当筛选器处于活动状态时,slowms 和 sampleRate 会被忽略,与筛选器不匹配的操作也不会像往常一样记录为慢查询。 与负责监控源部署的人员一起规划捕获期。

在运行评估之前,请在 mongosh 中于每个源 MongoDB 分片主节点上运行以下脚本,而不是在 mongos 路由器上运行。 使用有权 配置数据库分析的帐户。 该脚本会为除 admin、config 和 local 之外的每个数据库中包含聚合管道的命令启用分析功能。

// Run on each shard primary
const excluded = new Set(["admin", "local", "config"]);

db.adminCommand({ listDatabases: 1 }).databases
  .map(d => d.name)
  .filter(name => !excluded.has(name))
  .forEach(name => {
    db.getSiblingDB(name).setProfilingLevel(1, {
      filter: { "command.pipeline": { $exists: true } }
    });
    print(`Profiling enabled for ${name}`);
  });

启用分析时,使用 primary 读取首选项运行具有代表性的应用程序工作负荷,然后立即运行评估。 仅对分片主节点进行性能分析,无法捕获在辅助成员上执行的管道,包括按 secondary、secondaryPreferred 或 nearest 读取首选项路由到这些成员的读取。

评估会自动检测仍保留在 system.profile 中的条目里的跨集合管道依赖项。 不会捕获捕获期间未运行的管道,封顶集合会在满时覆盖较旧的条目。 在运行评估之前,请验证捕获期的条目是否保持可用。 无需为此检测生成或提供单独的数据评估日志。

评估完成后,使用 还原每个数据库的记录分析级别和选项。 如果数据库以前没有筛选器,则还原其设置时显式传递 filter: "unset" 。 仅降低分析级别不会删除筛选器。

我如何配置我的源服务器的防火墙以防止连接问题?

确保源 MongoDB 实例允许来自计算机的传入连接。

可以同时运行多少个评估?

可以同时进行的评估数量没有限制。 但是,并行运行多个评估会对计算机和源服务器上的计算资源造成压力,这可能会影响性能。

评估报告中包含哪些信息?

报告从有关评估的关键详细信息开始,包括源 MongoDB 环境的摘要。 本部分介绍源 MongoDB 版本、许可证类型和实例类型。 它还列出了评估的数据库和集合及其评估摘要和迁移准备情况。

调查结果分为 “严重”、“ 警告”和 “信息”,帮助你根据重要性确定优先级。

评估包括检查:

类别 Description
集合选项 标识不受支持的集合设置,例如时间序列配置和排序规则。
特征 检测不支持的数据库命令、查询语法和运算符,包括聚合管道查询。 “额外详细信息”列显示源实例上使用每个功能的频率。
限制和配额 重点介绍 Azure DocumentDB 配额和限制。
索引 标志不支持的 MongoDB 索引类型和属性。
分片键 标识不支持的分片密钥配置。

扩展生成的日志类型是什么?

扩展记录默认日志目录中的错误、警告和其他诊断日志:

  • Windows - C:\Users\<username>\.dmamongo\logs\
  • Linux - ~/.dmamongo/logs
  • macOS - /Users/<username>/.dmamongo/logs

注释

每天创建一个单独的日志文件。 默认情况下,扩展存储最后七个日志文件。

容量规划

群集层

从与源数据库配置相符的群集层开始。 执行负载和性能测试,以确定成本和性能之间的最佳平衡。

存储层

确保目标帐户预配足够的storage,以满足迁移期间和之后的数据要求。 首先迁移小型数据集以评估storage消耗量,然后根据总数据大小缩放估算值,以确定必要的storage分配。 保留额外的空间,以适应传入的数据和未来的增长。

后续步骤