创建迁移作业
迁移作业是负责将数据和模式从关系数据库传输到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。
如果连接字符串中未包含此名称,请输入要连接到的 Database。
如果连接字符串中未包含这些值,请输入Relational Migrator MongoDB用户的 和 。UsernamePassword
输入 Connection name 和可选的 Environment tag。
单击 Connect(连接)。
保存的连接可用于所有作业和项目。
在Migration Options 表单上,选择Migration Options :
迁移选项 | 说明 |
---|---|
模式 | 定义迁移作业的类型。 |
在迁移前删除目标collection | 布尔值。 指示 Relational Migrator 是否在传输数据前删除目标集合。 |
出错后停止 | 整数。指示Relational Migrator停止迁移作业之前出现的错误次数。 |
验证迁移的数据 | 布尔值。 如果为 true,则同步引擎会根据源数据库检查迁移的数据。 仅支持快照模式。 |
在Migration Options表单上指定作业类型后, Relational Migrator会执行各种检查,确保数据库配置正确。 如果缺少配置,则会显示一条横幅,指示数据库设置不正确,并提供用于下载SQL脚本的Generate Script按钮。
此脚本包括所需的声明和注释形式的附加说明。
警告
在继续启动迁移作业之前:
下载脚本。
仔细查看其内容。
执行语句。
按照任何带注释的手动步骤进行操作。
后续步骤
了解详情
有关每个数据库配置要求的详细信息,请参阅以下内容: