创建迁移作业
迁移作业是负责将数据和模式从关系数据库传输到MongoDB 的工作进程。 从 Data Migration(迁移作业)标签页创建新的迁移作业。
此任务也适用于Apache Kafka支持的持续迁移作业。 使用Kafka时不会引入程序差异。 有关更多详情,请参阅 将Relational Migrator与Kafka集成。
关于此任务
由于在 Confluent Cloud 上预配后端资源,使用 Confluent Cloud Kafka 的持续迁移作业可能需要额外时间。 首次运行 CDC迁移作业时,此进程通常还需要两到五分钟。
您可以在发生故障后的 24 小时内恢复持续迁移作业。 有关详细信息,请参阅恢复迁移作业。
开始之前
在 Relational Migrator 项目中创建一个或多个映射规则。
对于Atlas和本地部署部署,请为Relational Migrator创建一个单独的MongoDB用户,该用户具有MongoDB
readWrite
数据库的 访问权限。
步骤
输入关系数据库连接详细信息
在Connect to your source database表单上,输入连接详细信息,为关系数据库创建 JDBC URI。
要使用已保存的关系数据库连接,请单击Use a saved connection 并从下拉列表中选择它,然后输入凭证(如果需要)。
要创建新连接,请执行以下操作:
在 Database type 下拉列表中,选择数据库类型。
要直接输入连接字符串,启用 Enter URI manually开关并将连接字符串粘贴到JDBC URI 中。
要通过输入数据库信息来创建连接字符串,请输入以下内容:
字段值Host
托管IP或 DNS 名称。
Port
端口号。
Database
数据库名称。 必需。
Identifier
Service Name 或 SID 之一。
Username 和 Password
用于身份验证的凭证。
选中 Save password 会将密码安全地保存在计算机上,因此在使用保存的连接时,无需再次输入 Username 和 Password。
字段值Host
托管IP或 DNS 名称。
Port
端口号。
Database
数据库名称。 如果为空,则只能看到所有数据库中默认
dbo
模式中的对象。Authentication
Username 和 Password
用于身份验证的凭证。 如果将 Authentication设立为 Windows,则禁用。
选中 Save password 会将密码安全地保存在计算机上,因此在使用保存的连接时,无需再次输入 Username 和 Password。
General / SSL 切换
查看连接的 SSL 设置。
要使用 SSL,必须首先取消注释并更新
server.ssl
user.properties
文件中的 配置属性。SSL: Use SSL
启用或禁用 SSL。
SSL: Trust server certificate
启用 SSL 后,选中此项以信任存储的证书。 保持未选中状态可根据受信任的证书颁发机构验证服务器证书。
字段值Host
托管IP或 DNS 名称。
Port
端口号。
Database
数据库名称。 留空可加载所有数据库。
Username 和 Password
用于身份验证的凭证。
选中 Save password 会将密码安全地保存在计算机上,因此在使用保存的连接时,无需再次输入 Username 和 Password。
General / SSL 切换
查看连接的 SSL 设置。
要使用 SSL,必须首先取消注释并更新
server.ssl
user.properties
文件中的 配置属性。SSL: Use SSL
启用或禁用 SSL。
SSL: SSL mode
启用 SSL 后,请选择:
Preferred (默认):如果可能,建立加密连接,否则使用未加密连接。
Required:需要加密连接。
Verify CA:根据受信任的证书颁发机构验证服务器证书。
Verify identity:根据证书内容验证数据库连接信息。
字段值Host
托管IP或 DNS 名称。
Port
端口号。
Database
数据库名称。 留空可连接到默认数据库。
Username 和 Password
用于身份验证的凭证。
选中 Save password 会将密码安全地保存在计算机上,因此在使用保存的连接时,无需再次输入 Username 和 Password。
General / SSL 切换
查看连接的 SSL 设置。
要使用 SSL,必须首先取消注释并更新
server.ssl
user.properties
文件中的 配置属性。SSL: Use SSL
启用或禁用 SSL。
SSL: SSL mode
启用 SSL 后,请选择:
Prefer (默认):如果可能,建立加密连接,否则使用未加密连接。
Require:需要加密连接。
Verify CA:根据受信任的证书颁发机构验证服务器证书。
Verify full:根据证书内容验证数据库连接信息。
字段值Host
托管IP或 DNS 名称。
Port
端口号。
Database
数据库名称。 必需。
Username 和 Password
用于身份验证的凭证。
选中 Save password 会将密码安全地保存在计算机上,因此在使用保存的连接时,无需再次输入 Username 和 Password。
字段值Host
托管IP或 DNS 名称。
Port
端口号。
Database
数据库名称。 留空可连接到默认数据库。
Username 和 Password
用于身份验证的凭证。
选中 Save password 会将密码安全地保存在计算机上,因此在使用保存的连接时,无需再次输入 Username 和 Password。
输入 Connection name 和可选的 Environment tag。
单击 Connect(连接)。
保存的连接可用于所有作业和项目。
输入MongoDB连接详细信息
要使用已保存的MongoDB连接,请单击 Use a saved connection并从下拉列表中选择它,然后根据需要输入凭证。
要创建新连接,请执行以下操作:
输入MongoDB连接字符串。
在MongoDB connection string (URI) 中,输入您的MongoDB URI。
如果您使用的是 X.509 身份验证, Relational Migrator会验证连接字符串语法和证书文件格式。
如果连接字符串中未包含此名称,请输入要连接到的 Database。
如果它们未包含在连接字符串中,并且您未使用 X.509 UsernamePassword身份验证,请输入您的Relational Migrator MongoDB用户的 和 。
输入 Connection name 和可选的 Environment tag。
单击 Connect(连接)。
保存的连接可用于所有作业和项目。
在Migration Options 表单上,选择Migration Options :
迁移选项 | 说明 |
---|---|
模式 | 定义迁移作业的类型。 |
在迁移前删除目标collection | 布尔值。 指示 Relational Migrator 是否在传输数据前删除目标集合。 |
出错后停止 | 整数。 指示Relational Migrator停止迁移作业之前出现的错误次数。 |
验证迁移的数据 | 布尔值。 如果为 true,则同步引擎会根据源数据库验证迁移的数据。 仅支持快照模式。 |
设立Mode 时, Relational Migrator会检查数据库配置是否正确。 如果发现问题,则会显示警告横幅和用于下载SQL脚本的Generate Script按钮。 此脚本包括所需的配置语句以及作为注释的任何其他说明。
警告
在开始迁移作业之前:
下载脚本。
仔细查看其内容。
执行语句。
按照任何带注释的手动步骤进行操作。
查看并开始迁移作业
在 Review Summary 表单上,您可以查看有关迁移作业的详细信息。 这些详细信息包括迁移作业的类型、受影响的表和行的数量以及估计的数据大小。 要启动迁移作业,请单击 Start。
要查看Kafka迁移作业的部署详细信息,请在 Data Migration 屏幕的 History 窗格中选择作业,并将鼠标悬停在 Create Migration Job 按钮旁边的图标上。
重要
对于到Atlas 集群的大型迁移作业,“查看摘要”可能包括推荐更高集群层的Atlas Performance Suggestions。 升级是可选的,但可缩短迁移时间。
单击 Upgrade on Atlas 在新的浏览器标签页或窗口中打开Atlas 。 如果您想升级,但没有必要的权限,请联系管理员。
后续步骤
了解详情
有关每个数据库配置要求的详细信息,请参阅以下内容: