实施对象迁移

本章节介绍如何迁移已创建的迁移任务。

操作步骤

在对象迁移页面，单击待迁移项目的“操作 > 迁移”，进入“语法转换配置”页面。

图1 设置转换配置
- 设置转换配置参数。有两种方式：
  - 默认情况下，使用默认模板，在各个转换配置项中单击“操作 > 编辑”，查看配置详情，根据实际使用场景进行详细设置。
  - 优先最大化迁移成功率的场景下，可在“基线模板”下拉框选择最大兼容性模板，并根据实际使用场景进行微调。
- （可选）单击“表空间映射”，进入表空间页面。
  若需添加表空间映射关系，可选择需要的源数据库表空间和对应的目标数据库表空间，单击“映射表空间”。
- （可选）单击“标签”，进入“标签”页面。
  若需添加标签，可单击“编辑标签”，在“编辑标签”弹出框中，单击“添加标签”，输入标签的键和值。
单击“下一步”，进入“语法转换”页面。
（可选）选择需要转换和迁移的对象。可以按照“全部时间”或“具体对象名称”进行搜索，也可依据“Schema”、“对象状态”以及“转换对象”进行筛选。

图2 待启动转换
- 界面选取转换对象。
  - 单击“全选”或者“取消全选”所有对象是否全部选中或者取消选中。
  - 单击Schema前的复选框，勾选转换的具体的对象，单击“关闭转换”或者“开启转换”，选择对象是否迁移，支持批量操作。可通过对象名称、对象状态等进行过滤筛选。
- 使用配置策略选取转换对象。单击待迁移项目的“操作 > 迁移>语法转换”，下划进入“对象列表”页面，单击“配置策略”，弹出“配置策略”页面。
  图3 配置策略
- 覆盖手工修改结果：
  - 不勾选：默认“不勾选”“覆盖手工修改结果”，再次启动转换，不会覆盖手工修改的SQL语句。
  - 勾选：若“勾选”“覆盖手工修改结果”，再次启动转换，会覆盖手工修改的SQL语句，请谨慎操作，防止手工修改SQL被再次重新转换结果覆盖掉。
- 选择转换模式：
  - 按对象类型转换，可选择需要迁移的具体对象类型。
  - 导入转换对象，下载模板，将待转换对象的信息填入Excel文件，上传Excel文件。详情可参考4。
（可选）导入转换对象。

单击待迁移项目的“操作 > 迁移>语法转换”，下划进入“对象列表”页面。
图4 对象列表
单击“配置策略”按钮，弹出“配置策略”窗口，单击“导入转换对象”。
图5 导入转换对象
- 单击“下载Excel文件模板”，下载对应模板。
  - Excel表格第一列为Schema，第二列为对象类型，第三列为对象名称，三列唯一指定一个对象（内容区分大小写），都不可为空。
- 通过上传Excel，批量指定需要转换的对象。
  - 表格最大不超过30M，行数最多为65535行（不包括表头），若内容有错误，可通过上传结果的“查看错误”查看错误原因，修改后可直接再次上传。
  - 表格上传成功后，对象的“是否转换”自动更新。
  - “导入转换对象”上传Excel文件时，识别列表中符合schema、对象类型及对象名称的所有对象，均标记为“正常”状态。
进入“转换任务”界面，单击“启动”，进行语法转换。

图6 转换任务
- 转换完成之前，可以单击“暂停”，流程将被暂停。单击“恢复”，将继续进行转换流程。
- 转换完成后，可单击“转换报告”，进入最近一次转换报告页面，单击“下载报告”，选择所需报告单击“下载”，下载至本地供用户分析。
  - 转换错误及风险报告：该报告介绍了无法等价转换为目标库语法的源库对象详情，以及介绍了基于用户所选的配置项，冒一定风险转换为目标库语法的源库对象，但转换后存在一定的功能差异。
  - 匿名化转换错误及风险报告：该报告通过匿名方式介绍了无法等价转换为目标库语法的源库对象，以及介绍了基于用户所选的配置项，冒一定风险转换为目标库语法的源库对象，但转换后存在一定的功能差异。
- 转换完成后，可单击“转换报告”进入“转换报告”页面，单击“转换历史”，可查看转换历史详情信息，单击“操作>详情”，进入对象类型转换详情页面，选择具体对象类型，再次“单击操作>详情”，可按“schema”查看具体对象转换情况，也可按“转换状态”查看具体对象转换情况，也可按“对象名称搜索”查看具体对象的转换情况。
（可选）语法转换迁移完成，若有转换失败对象，下划进入“对象列表”页面，可进行单独语法转换修改并直接迁移。

图7 对象列表-语法转换完成但是未迁移

单击待修改对象“操作 > 对象校正”，进入对象详细信息页面。可以查看“转换错误”、“转换风险”信息和“修改”建议。
图8 对象详细信息-转换错误和告警

对转换失败的对象进行SQL语句修改。单击“保存”，“转换状态”标记为“手工修改”，然后单击“迁移”，跳出弹框确认是否在目标数据库执行单条SQL语句，单击“确认”。
图9 单条SQL直接迁移验证
单击“下一步”，进入“迁移验证”界面。

图10 迁移任务

进入“迁移任务”页面，单击“迁移验证配置”，弹出“迁移验证配置”页面
图11 迁移验证配置
- 转换失败对象是否迁移：
  - 不勾选：默认“不勾选”“迁移转换失败对象”，转换失败对象不参与迁移任务。
  - 勾选：“勾选”“迁移转换失败对象”，转换失败对象参与迁移任务。
- 用户连接：
  - 默认“勾选”“将数据库连接用户设置为执行GaussDB脚本的用户”，因此各个schema的owner为数据库连接用户。若“勾选”“将对象所有者设置为执行GaussDB脚本的用户”，则各个schema的owner为schema自己。
- 修改用户密码：
  - 当待转换对象中包含USER对象时，需要为用户设置统一的密码，设置的密码将用于目标数据库上创建所有用户对象，迁移后需要逐一手动修改用户的密码。
单击“启动”开始进行迁移验证，开始将对象迁移至目标数据库中。
- 迁移成功：进入“对象列表”页面，“迁移状态”标记为“成功”，可登录目标库查看迁移对象。
- 迁移失败：进入“对象列表”页面，“迁移状态”标记为“失败”，进入“对象列表”页面，单击迁移失败对象后的“对象校正”，跳转至10，重新进行对象的手工修改并迁移验证。
迁移完成后，单击“迁移报告”，弹出“迁移报告”页面：

图12 迁移报告
- “最近一次迁移报告”页面，显示最近一次迁移项目的详细信息，包括对象类型、总数、迁移成功、迁移失败、剩余量等信息。当在“迁移验证配置”中设置了不迁移转换失败对象时，还会展示“转换失败不迁移”，以及迁移成功率等信息。
- “迁移历史”页面，以倒序方式显示迁移历史记录，包括序号、总数、迁移成功、迁移失败、迁移状态、开始时间、结束时间，可以单击“操作>详情”查看详细信息。
  - 单击“详情”，显示对象类型、总数、迁移成功、迁移失败等信息。可以查看各对象类型的详细信息。
  - 单击对象类型后的“详情”，显示Schema、对象名称、对象类型、迁移状态等信息。可以依据具体对象名称搜索，也可以查看各Schema的详细信息。
  - 单击对象后的“详情”，显示目标库详细代码信息以及迁移报错信息。
- 单击“下载报告”，选择所需报告单击“下载”，下载至本地供用户分析。子对象的相关数据不会统计在迁移报告中。
  - 迁移统计报告：该报告简要介绍了迁移和验证对象的状态。
  - 迁移错误报告：该报告介绍了对象迁移失败的详情，包括每个对象的状态、迁移语句和错误信息。
  - 迁移错误报告（匿名化）：该报告介绍了对象迁移失败的详情，包括每个对象的状态、迁移语句、错误信息，但源库SQL语句和迁移后的SQL语句均以匿名的形式呈现。
  - 迁移全量报告：该报告介绍了对象迁移的详情，包括每个对象的状态、迁移语句和错误信息。
  - 迁移全量报告（匿名化）：该报告介绍了对象迁移的详情，包括每个对象的状态、迁移语句和错误信息。但源库SQL语句和迁移后的SQL语句均以匿名的形式呈现。
迁移验证完成后，若有迁移失败项，下划到“对象列表”页面，进行单独修改并直接迁移或批量语句更新。

图13 迁移验证失败
- 选择可忽略的迁移对象并单击“关闭迁移”，“迁移状态”变为“忽略”。也可以“开启迁移”，撤销后对应状态恢复原样。
- 单击“批量语句更新”，批量语句更新支持类似问题的批量搜索和修改。
- 单击单条迁移失败修改对象“操作 > 对象校正”，进入对象详细信息页面。可以查看“迁移错误”和“修改”建议。
  图14 对象详细信息-迁移错误
对迁移失败的对象进行SQL语句修改。单击“保存”，“迁移状态”标记为“待启动”，然后单击“迁移”，跳出弹框确认是否在目标数据库执行单条SQL语句，单击“确认”。
图15 单条SQL直接迁移验证
- 建议按照管理、存储、代码、作业对象的顺序进行对象校正。
（可选）单击“修改历史”按钮，查看修改历史。单击历史ID前的下拉图标，展示修改前后SQL对比。

单击对应时间后的“回滚”，可以回滚至此次修改前的状态。
图16 修改历史
迁移失败对象全部修改完并迁移到目标数据库，迁移任务完成。