结构迁移操作说明

本文为您介绍 OceanBase 迁移服务（OceanBase Migration Service，OMS）社区版数据迁移项目中的结构迁移支持的操作。

背景信息

结构迁移负责迁移源库中的数据对象定义（表、索引、约束、注释和视图等）至目标库中，会自动过滤临时表。当源端数据库非 OceanBase 数据库时，会依据目标 OceanBase 租户类型的语法定义标准进行数据类型和 SQL 语法的自动转换和拼装，然后复制至目标库中。

数据迁移项目在通过预检查后，会进入 结构迁移 步骤。您可以进入数据迁移项目的详情页面，单击 结构迁移 页签，查看结构迁移的整体状态、启动时间、结束时间、总计耗时，以及表和视图的迁移进度。

结构迁移任务处于 运行中 或 失败 状态时，您可以对不同状态的目标对象进行不同的操作，如下表所示。结构迁移任务处于 已完成 状态时，仅支持查看目标对象的创建语法。

前提条件

已创建并启动数据迁移项目，详情请参见 数据迁移 模块相应类型的创建数据迁移项目文档。

使用限制

• 本文介绍的结构迁移操作适用于 运行中 或 失败 状态的结构迁移任务，处于 已完成 状态的结构迁移任务仅支持查看目标对象的创建语法。

• 结构迁移支持迁移表、索引、视图、comments 和 Check 约束，不支持迁移临时表、event、type、function 和 procedure 等对象或者约束。

重试/重试全部失败对象

处于 失败 和 获取 DDL 失败 状态的目标对象，支持进行单个重试或全部重试操作。您可以直接重试，也可以修改对象后再进行重试。

• 重试单个失败对象：在 结构迁移 页面，单击失败对象操作列的 重试 即可。

• 重试全部失败对象

  1. 在 结构迁移 页面，单击右上角的 重试全部失败对象。

  2. 在对话框，单击 确定。

跳过目标对象

处于 失败 和 获取 DDL 失败 和 不支持 状态的目标对象，支持进行跳过操作。

跳过目标对象的操作如下：

1. 在 结构迁移 页面，单击目标对象操作列的 跳过。

2. 在对话框，单击 确定。

移除目标对象

处于 失败、已完成、已完成（有转换）、已跳过、获取 DDL 失败 和 不支持 状态的目标对象，均支持进行移除操作。

1. 在 结构迁移 页面，单击目标对象操作列的 移除。

2. 在对话框，单击 确定。

修改创建语法

处于 失败 和 获取 DDL 失败 状态的目标对象，支持修改表的创建语法。

1. 在 结构迁移 页面，单击目标对象操作列的 更多操作 > 修改。

2. 在 修改表创建语法 对话框，对运行失败的 DDL 和报错进行检查，并修改该条 DDL 转换结果的定义。

3. 单击 保存。

查看创建语法

除 初始化中 和 失败 状态外，其它状态的目标对象均支持查看表的创建语法。

在 结构迁移 页面，单击目标对象操作列的 查看，即可进行查看。如果表的创建语法完全兼容，将为您展示在 OBServer 节点执行的 DDL 语法。如果不完全兼容，则展示转换后的创建语法。

查看失败对象详情

处于 失败 状态的目标对象，支持查看报错详情。

1. 在 结构迁移 页面，单击目标对象操作列的 更多操作 > 查看详情。

2. 在 查看详情 对话框，查看运行失败的原因。