# 创建迁移项目 #### 操作场景 源数据库评估完成后，根据评估的结果分析，选择需要迁移的目标数据库，填写相关信息，创建对应的迁移项目。每个迁移项目对应一个评估项目，但可以基于一个评估项目多次创建迁移项目。 创建迁移项目分为两个步骤： - 步骤一：[确认目标数据库]。 - 步骤二：[创建数据库迁移项目]。 #### 使用须知 实施迁移时会对目标库性能存在影响，建议使用非生产环境的目标数据库，或者在业务低峰期进行。 #### 前提条件 - 用户需拥有创建UGO迁移项目的对应权限。具体权限，可参见[权限管理](https://support.huaweicloud.com/productdesc-ugo/ugo_01_0008.html)进行设置。 - 创建迁移项目至少需要一个状态显示为"完成"的数据库评估项目。 - 待使用的目标数据库类型及版本信息要与评估项目确认的目标库类型及版本一致。 - 待连接的目标库正常，无欠费、停机等情况。 - 确保提供的目标数据库可正常访问，且连接用户需要具有对于Schema、表、程序、索引、用户、函数、视图等迁移对象的创建、删除和更改的权限。 #### 确认目标数据库 1. [登录UGO控制台。](https://console.huaweicloud.com/ugo/#/console/dashboard) 2. 单击左侧导航栏"结构迁移 \> 数据库评估"。 3. 选择"项目状态"为"进行中-确认目标库"的待确认项目，单击"项目名称"或单击待确认项目"项目状态"列的"待确认目标数据库"。 4. 进入目标数据库分析页面，选中待迁移的目标数据库，单击"确认数据库选择"按钮。 5. 确认目标库选择后单击"确认"。 6. 目标数据库确认后，弹出提示框。 - 立即创建：页面跳转至创建迁移项目信息填写页面，可直接创建迁移项目。 - 稍后创建：不进行页面跳转，仍停留在"目标数据库分析"页签。 ![](https://support.huaweicloud.com/qs-ugo/public_sys-resources/note_3.0-zh-cn.png) - 确定后，数据库评估页面，该"项目状态"由"进行中 待确认目标数据库"变为"完成 创建迁移项目"。 #### 创建数据库迁移项目 1. [登录UGO控制台。](https://console.huaweicloud.com/ugo/#/console/dashboard) 2. 单击左侧导航栏"结构迁移 \> 对象迁移"。 3. 在对象迁移页面，单击右上角的"创建迁移项目"。 4. 在创建迁移项目页面，完成信息的填写，具体参见[表1]。 图1创建迁移项目 ![](https://support.huaweicloud.com/qs-ugo/zh-cn_image_0000002443681688.png "点击放大") 5. 单击"测试连接"进行检查。 - 测试连接成功：按钮高亮显示，同时"下一步"按钮高亮显示。 - 测试连接失败：弹出"错误"提示框。 6. 单击"下一步"进入预检查界面。 图2预检查 ![](https://support.huaweicloud.com/qs-ugo/zh-cn_image_0000002118871980.png "点击放大") - 对于"检查结果"为"失败"的检查项，单击"操作 \> 查看详情"，根据提示进行操作后，单击"重新开始预检查"重新检测。所有检查项"检查结果"为"成功"或"警告"时，"下一步"按钮才会被激活。 - 若已了解检查项未处理可能会对迁移造成的不良影响，仍想要创建项目，可单击"跳过检查失败项"，"失败"的检查项结果变为"警告"，"下一步"按钮被激活。 ![](https://support.huaweicloud.com/qs-ugo/public_sys-resources/note_3.0-zh-cn.png) 目标库为GaussDB时，会进行以下检查： - 兼容模式检查，详情参见[兼容模式检查](https://support.huaweicloud.com/usermanual-ugo/ugo_03_0431.html)。 - 字符集检查，详情参见[字符集检查](https://support.huaweicloud.com/usermanual-ugo/ugo_03_0432.html)。 - GUC参数检查，详细检查项参考[GUC参数检查](https://support.huaweicloud.com/usermanual-ugo/ugo_03_0433.html)。 - 用户权限检查，详情参见[用户权限检查](https://support.huaweicloud.com/usermanual-ugo/ugo_03_0434.html)。 - 数据库可写检查，检查数据节点是否处于正常状态，若目标数据库处于只读状态，展示此检查项。检查结果为"不通过"。 7. 单击右下角"下一步"，进入信息确认。 图3信息确认 ![](https://support.huaweicloud.com/qs-ugo/zh-cn_image_0000002107855749.png "点击放大") 信息确认界面显示数据库迁移范围、迁移任务信息、目标数据库信息。 8. 信息确认后，单击右下角"创建"。创建成功后，单击"确定"。返回对象迁移列表页面。 图4迁移任务创建成功 ![](https://support.huaweicloud.com/qs-ugo/zh-cn_image_0000002629394976.png "点击放大") #### 参数说明 表1创建迁移项目参数说明 | **参数名称** | **示例** | **说明** | |:---|:---|:---| | 项目名称 | **oracle_to_gaussdb_migration_project_01** | 项目名称必须唯一。 长度范围为5到50个字符，只允许包含字母、数字、下划线、中划线，不区分大小写且必须以字母开头、数字或字母结束。 | | 异常通知方式（可选） | **smn_subject_01** | 默认方式为SMN主题。 若出现异常情况，是否通过消息通知服务（Simple Message Notification）向用户发送消息。 若需要发送消息，需要先创建SMN主题，具体请参见[创建主题](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043961401.html)。 说明： **后续操作**： 创建完主题后，您就可以[添加订阅](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043961402.html)了。完成创建和添加订阅后，后续的警告通知即可通过SMN服务发送到您配置的订阅终端。 **通知场景：** 当该账号被冻结或解冻时，可通过SMN发送通知消息。 | | 选择评估项目 | **oracle_to_gaussdb_evaluation_project_01** | 下拉选择已确认目标数据库的评估项目。 - 目标数据库：显示已选定的目标数据库类型。每个租户最多可同时连接5个目标数据库。 - 目标数据库版本：显示已选定的目标数据库版本。 | | 数据库连接方式 | **公网** | 选择"公网"，通过弹性公网IP（Elastic IP，EIP）连接目标数据库，需要填写"主机名"（或"主机IP地址"）和"主机端口"。 - 如果目标库网络有IP白名单限制，请将弹性公网IP添加至目标库网络白名单，确保UGO可以连接目标库。 - 华南-广州弹性公网IP：124.71.59.255 - 选择"主机IP地址"，需要填写具体目标库"主机IP地址"说明。 - 当目标库为GaussDB集中式版时，支持只填写主节点IP，或主节点+多个备节点IP，IP地址之间用英文逗号分隔，连接数据库时，系统会自动选择主节点ip进行连接。 - 当目标库为GaussDB分布式版时，支持填写一个或多个CN节点IP，IP地址之间用英文逗号分隔，连接数据库时，优先使用输入靠前的IP进行连接;若前一个IP节点异常导致无法创建连接，会尝试使用下一个IP创建连接;若第一个可连接的IP节点异常导致不可写，则测试连接正常，但权限检查、迁移对象将会报错提示。 - 选择"主机名"，则需要填写"主机名"格式说明。 - 主机名不能为空。 - 支持多个主机名，总长度不超过1024位，各个主机名之间用英文逗号分隔。 - 单个主机名长度不超过253位，不允许包含以下特殊符号!@#$%\^\&\*()+=\[\]{}\|\\\\:;\<\>,?/。 - 主机端口：目标数据库的端口。 - 当目标数据库选择为GaussDB集中式版（A兼容，透明多写）V2.0-9.1企业版、GaussDB分布式版 （A兼容，透明多写）V2.0-9.1企业版、GaussDB集中式版（A兼容，透明多写）V2.0-10.0企业版或者GaussDB分布式版 （A兼容，透明多写）V2.0-10.0企业版时，需要填写"租户名"和"租户密码"。 - 租户名：目标数据库的租户名。 - 租户密码：目标数据库的租户密码 选择"终端节点服务"，则需要选择"终端节点服务"实例，以及"端口映射"。 - 单击"查看终端节点服务"，可跳转至终端节点服务管理界面，查看当前终端节点列表。 - 如何配置终端节点服务，请参考[使用终端节点服务连接数据库](https://support.huaweicloud.com/drawer-ugo/ugo_7_0006.html)。 选择"数据源信息"，可选择"数据源管理"中的数据源，自动填充表单信息。 | | 主机端口 | 8000 | 填写目标数据库的端口 | | 数据库名称 | **target_db_01** | 填写对应的数据库名称。 请输入由字母、数字、.、_、-、$、#、空格组成，长度是2-128个字符，必须以字母、数字、.、_、-、空格开头且允许使用"包裹的名称。 | | 用户名 | **target_user_01** | 目标数据库的用户名。建议连接用户应具有管理员角色。 | | 密码 | **Pass@worD#\&** | 目标数据库的密码。 | | 租户名 | **target_user_02** | 当目标数据库选择为GaussDB集中式版（A兼容，透明多写）V2.0-9.1企业版、GaussDB分布式版 （A兼容，透明多写）V2.0-9.1企业版、GaussDB集中式版（A兼容，透明多写）V2.0-10.0企业版或者GaussDB分布式版 （A兼容，透明多写）V2.0-10.0企业版时，需要填写"租户名"。租户名：目标数据库的租户名。 | | 租户密码 | **Pass@worD#\&** | 当目标数据库选择为GaussDB集中式版（A兼容，透明多写）V2.0-9.1企业版、GaussDB分布式版 （A兼容，透明多写）V2.0-9.1企业版、GaussDB集中式版（A兼容，透明多写）V2.0-10.0企业版或者GaussDB分布式版 （A兼容，透明多写）V2.0-10.0企业版时，需要填写"租户密码"。租户密码：目标数据库的租户密码。 | | 选择要迁移的Schema | **全部迁移** | - 全部迁移：选择UGO从源数据库收集的模式范围，以执行迁移任务。 - 不全部迁移：选择已评估项目中的 Schema，可缩小迁移范围。 默认勾选"全部迁移"。 | | SSL类型 | **不使用 SSL** | - 不使用SSL：将启用不安全协议，存在潜在风险。 - 无身份验证SSL：将启用安全加密传输。 - 单向SSL：将对数据库身份进行认证并启用安全加密传输。 - 输入信任密码：用于访问证书的信任库密码。 - 上传证书文件：单击后找到目标库的根证书文件进行上传。 说明： - 若选择"单向SSL"，必须同时正确选择上传文件、填写信任密码，这些信息为用户私有。但当目标库为GaussDB和PostgreSQL时，需上传PEM类型的根证书文件，且不需要输入密码。 - SSL（Secure Socket Layer，安全套接层），位于可靠的面向连接的网络层协议和应用层协议之间的一种协议层。SSL通过互相认证、使用数字签名确保完整性、使用加密确保私密性，以实现客户端和服务器之间的安全通讯。如果不启动SSL安全连接，请自行承担数据安全风险。 | | 标签（可选） | **tag_key_01 = tag_value_01** | 可使用TMS的预定义标签功能将相同的标签添加到不同的云资源中。具体请查看[标签管理服务 TMS](https://support.huaweicloud.com/usermanual-tms/zh-cn_topic_0056266263.html)。 输入一对一的"键"和"值"后单击"添加"。 最多可添加20个标签。具体操作详见[标签](https://support.huaweicloud.com/usermanual-ugo/ugo_03_0031.html)。 |