# 创建评估项目 #### 操作场景 创建数据库评估是对源库的基本信息，以及特定的源库对象进行SQL采集，分析生成评估报告，是进行数据库迁移的必要前提，通过对源数据库的评估，采集出源库Schema数量，评估迁移工作量以及迁移风险，推荐合适目标等，可以帮助用户在迁移时，进行决策与工作规划。 #### 使用建议 - 由于连接源库采集对象，会影响源库性能，建议采用非生产环境数据库，或者在业务低峰期进行评估。 - GoldenDB为源库时，建议使用CN节点上用户来创建评估任务。 #### 约束限制 - 源数据库为MySQL 、GoldenDB、MariaDB 或 DDM 时,用户名称不支持特殊字符，包括单引号、双引号、反斜杠等。 - 同一套源库中UGO不支持评估同名的重载函数。 - 每个用户最多支持评估任务配额为10个。 #### 操作步骤 1. [登录UGO控制台。](https://console.huaweicloud.com/ugo/#/console/dashboard) 2. 单击左侧导航栏"结构迁移 \> 数据库评估"。 3. 在评估数据库页面，单击右上角的"创建项目"。 4. 进入"基本信息"页面，完成基本信息的填写。具体参数详见[表1]。 图1创建评估项目 ![](https://support.huaweicloud.com/qs-ugo/zh-cn_image_0000002477722077.png "点击放大") 5. 基本信息填写完成后，单击"开始测试"。 - 测试连接成功："下一步"按钮高亮显示。 - 测试连接失败：给出错误提示"无法连接到数据库"，详情可参考[测试连接到数据库报错](https://support.huaweicloud.com/ugo_faq/ugo_04_0023.html)。 6. （可选项）测试网络稳定性。测试网络稳定性成功仅表示当前测试时网络时延低，无丢包或丢包率很低。该测试过程需要持续10到15s。 7. 单击"下一步"，进入预检查页面。 图2Oracle为源库预检查 ![](https://support.huaweicloud.com/qs-ugo/zh-cn_image_0000001969450073.png "点击放大") ![](https://support.huaweicloud.com/qs-ugo/public_sys-resources/note_3.0-zh-cn.png) 若存在失败项，会显示失败检查项的失败原因及修改建议，参考"建议"进行修改后"重新开始预检查"。 Oracle为源数据库： - 如果"DBMS_METADATA权限检查"、"动态视图权限检查"和"Schema对象数量检查"失败，将无法进行下一步。 - 如果"DBMS_METADATA SQL格式化参数设置"的"检查结果"为"警告"，评估项目可以创建成功，但是采集出的SQL格式可能存在问题，导致评估和转换失败。 MySQL和GoldenDB为源数据库："MySQL8.0 SHOW_ROUTINE权限检查"可以为"警告"，剩余检查项必须检查通过，否则无法进行下一步。 Microsoft SQL Server为源数据库：所有检查项必须检查通过，否则无法进行下一步。 openGauss为源数据库： - 如果"DDL对象数量检查"、"SEQUENCE采集权限检查"失败，将无法进行下一步。 - 如果"PG_AUTHID视图查询权限"的"检查结果"为"警告"，评估项目可以创建成功，但在选择评估范围时需取消 ROLE 和 GRANT 对象的采集，否则会导致评估的失败。 - 如果"SEQUENCE采集权限检查"、"VIEW采集权限检查"的"检查结果"为"警告"，评估项目可以创建成功，但存在部分 SEQUENCE 或 VIEW 对象无法采集。 - 如果"Schema使用权限检查"的"检查结果"为"警告"，评估项目可以创建成功，但缺少 USAGE 权限的 Schema 中的物化视图对象无法采集。 DDM为源：所有检查项必须检查通过，否则无法进行下一步。 8. 所有结果均成功后，单击"下一步"。进入选择评估范围页面。参数配置详情参见[表2]和[表3]。 图3选择评估范围 ![](https://support.huaweicloud.com/qs-ugo/zh-cn_image_0000002072050814.png "点击放大") ![](https://support.huaweicloud.com/qs-ugo/public_sys-resources/note_3.0-zh-cn.png) - 程序只会采集用户选择范围内的数据库对象，即勾选的Schema下的对象。 - 所有采集的数据存储在租户区的源数据库中，数据库密码会加密存储，相关数据只有用户在UGO界面可见。 - 当用户删除评估任务时，用户数据将被删除。 - 仅当Oracle为源数据库时，支持动态SQL相关评估，以及对象级权限采集。 9. 选择完成后，单击"下一步"，进入任务确认页面。 - 显示基础信息、预检查情况、选定的目标数据库、已选择及未选择的 Schema 和对象类型。 图4任务确认-Oracle为源 ![](https://support.huaweicloud.com/qs-ugo/zh-cn_image_0000002140036494.png "点击放大") ![](https://support.huaweicloud.com/qs-ugo/public_sys-resources/note_3.0-zh-cn.png) 不同源数据库在任务确认页面展示的参数略有不同，请以实际为准。 10. 检查无误后，单击"创建"。显示"项目创建成功"。 11. 单击"确定"，返回数据库评估页面，用户可以看到最新创建的评估项目已在列表中。 需要经过数据采集、项目评估和预迁移评估，可在"项目状态"中查看实时状态。也可"停止"或"恢复"正在评估的项目。 图5评估任务创建成功 ![](https://support.huaweicloud.com/qs-ugo/zh-cn_image_0000002004813413.png "点击放大") ![](https://support.huaweicloud.com/qs-ugo/public_sys-resources/note_3.0-zh-cn.png) - 一个租户下，只能创建10个评估项目。 - "项目状态"为"进行中 待确认目标数据库"之前，可停止及恢复正在创建的评估项目。当"项目状态"为"进行中 待确认目标数据库"时，可直接[确认目标数据库](https://support.huaweicloud.com/qs-ugo/ugo_02_0009.html#ugo_02_0009__section19570133919432)，也可以"重新评估"。但GoldenDB源库不支持"重新评估"。 - 等待时间依据所选对象数量而定。 - 评估完成后，可单击具体"项目名称"，[查看数据库评估结果](https://support.huaweicloud.com/qs-ugo/ugo_02_0008.html)。 - 数据库采集过程中，如果与源数据库的连接中断，系统内部的自动重试机制会定期测试其与源数据库的连接，并重试连接。下次重试连接时间：当前时间 + 检查测试连接和网络稳定性连接所需的时间 + 重试睡眠间隔。每次检查测试连接和网络稳定性连接所需的时间有几秒的误差。因此，用户可能会看到两个重试时间之间相差几秒。 #### 参数说明 表1基本详情参数说明 | **参数名称** | **示例** | **说明** | |:---|:---|:---| | 项目名称 | **oracle_to_gaussdb_evaluation_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服务发送到您配置的订阅终端。 | | 源数据库类型 | **Oracle** | 请选择源数据库类型。当前支持的源库类型参见[支持的数据库](https://support.huaweicloud.com/productdesc-ugo/ugo_01_0011.html)。 如果您需要选择GoldenDB、MariaDB-10.6为源库，需要在管理控制台右上角，选择"[工单 \> 新建工单](https://console.huaweicloud.com/ticket/#/ticketindex/createIndex)"，联系客服开通白名单。 说明： 若选择MySQL为源数据库，需在源数据库中进行如下设置，启用CPU计数。 **SET GLOBAL innodb_monitor_enable = cpu_n;** | | 数据库连接方式 | **公网** | 用于选择连接源数据库的方式。默认选择"公网"。 选择"公网"，则通过弹性公网 IP（Elastic IP，EIP）连接源数据库。可选择通过"服务名称"或"连接字符串"连接源数据库。 - 如果源库网络有 IP 白名单限制，请将弹性公网 IP 添加至源库网络白名单，确保 UGO 可以连接源库。 - 华南-广州弹性公网 IP：124.71.59.255 选择"终端节点服务"，则需要选择"终端节点服务"实例，以及"端口映射"。 - 单击"查看终端节点服务"，可跳转至终端节点服务管理界面，查看当前终端节点列表。 - 如何配置终端节点服务，请参考[使用终端节点服务连接数据库](https://support.huaweicloud.com/drawer-ugo/ugo_7_0006.html)。 | | 连接方法（"数据库连接方式"选择"公网"时需要设置） | **服务名称** | 当"数据库连接方式"选择"公网"时，需要设置"连接方法"。可选择"服务名称"、"连接字符串"或"数据源信息"。默认选择"服务名称"。 选择"服务名称"时，需填写"源数据库名称"、"主机端口"，并选择填写"主机IP地址"或"主机名"信息。 - "源数据库名称"用于输入待评估数据库的名称，需要满足以下规则： - 由字母、数字、.、_、-、$、#、空格组成。 - 长度是2-128个字符。 - 必须以字母、数字、.、_、-、空格开头且允许使用引号（"）包裹的名称。 说明： 当 MySQL 为源数据库时，不显示该参数。 - "主机端口"用于输入待评估数据库开放的通讯端口，端口范围为 1-65535。 - 选择"主机IP地址"，需要填写具体源库"主机IP地址"。不支持IPv6格式的主机IP地址。 - 选择"主机名"，则需要填写"主机名"。 - 主机名不能为空。 - 支持多个主机名，总长度不超过 1024 位，各个主机名之间用英文逗号分隔。 - 单个主机名长度不超过 253 位，不允许包含以下特殊符号!@#$%\^\&\*()+=\[\]{}\|\\\\:;\<\>,?/。 选择"数据源信息"时，会弹出数据源列表，可选择"数据源管理"创建的数据源。 选择"连接字符串"时，需填写"连接字符串"信息，各数据库连接字符串格式不同，以下格式供参考。 - Oracle： 兼容 IPv4 的 JDBC 格式： 1. ip:port:databaseName 2. ip:port/databaseName 3. jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=ip)(PORT=port)))(CONNECT_DATA=(SERVICE_NAME=databaseName))) 4. jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCPS)(HOST=ip)(PORT=port)))(CONNECT_DATA=(SERVICE_NAME=databaseName))) - MySQL： 兼容 IPv4 的 JDBC 格式： 1. jdbc:mysql://ip:port/databaseName?useUnicode=true\&characterEncoding=UTF-8 2. jdbc:mysql://ip:port/databaseName?useUnicode=true\&characterEncoding=UTF-8\&useSSL=true\&requireSSL=true 3. jdbc:mysql://ip:port/databaseName?useUnicode=true\&characterEncoding=UTF-8\&allowPublicKeyRetrieval=true 4. jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true\&characterEncoding=UTF-8 5. jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true\&characterEncoding=UTF-8\&useSSL=true\&requireSSL=true 6. jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true\&characterEncoding=UTF-8\&allowPublicKeyRetrieval=true - PostgreSQL： 兼容 IPv4 的 JDBC 格式： 1. jdbc:postgresql://ip:port/databaseName - GoldenDB： 兼容 IPv4 的 JDBC 格式： 1. jdbc:mysql://ip:port/databaseName?useUnicode=true\&characterEncoding=UTF-8 2. jdbc:mysql://ip:port/databaseName?useUnicode=true\&characterEncoding=UTF-8\&useSSL=true\&requireSSL=true 3. jdbc:mysql://ip:port/databaseName?useUnicode=true\&characterEncoding=UTF-8\&allowPublicKeyRetrieval=true 4. jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true\&characterEncoding=UTF-8 5. jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true\&characterEncoding=UTF-8\&useSSL=true\&requireSSL=true 6. jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true\&characterEncoding=UTF-8\&allowPublicKeyRetrieval=true - MariaDB： 兼容IPv4的JDBC格式： 1. jdbc:mariadb://ip:port/mysql?useUnicode=true\&characterEncoding=UTF-8 2. jdbc:mariadb://ip:port/mysql?useUnicode=true\&characterEncoding=UTF-8\&useSSL=true\&requireSSL=true 3. jdbc:mariadb://ip:port/mysql?useUnicode=true\&characterEncoding=UTF-8\&allowPublicKeyRetrieval=true 4. jdbc:mariadb://address=(protocol=tcp)(host=ip)(port=port)/mysql?useUnicode=true\&characterEncoding=UTF-8 5. jdbc:mariadb://address=(protocol=tcp)(host=ip)(port=port)/mysql?useUnicode=true\&characterEncoding=UTF-8\&useSSL=true\&requireSSL=true 6. jdbc:mariadb://address=(protocol=tcp)(host=ip)(port=port)/mysql?useUnicode=true\&characterEncoding=UTF-8\&allowPublicKeyRetrieval=true - openGauss： 兼容IPv4的JDBC格式： 1. jdbc:opengauss://ip:port/databaseName - DDM： 1. jdbc:mysql://ip:port/databaseName?useUnicode=true\&characterEncoding=UTF-8 2. jdbc:mysql://ip:port/databaseName?useUnicode=true\&characterEncoding=UTF-8\&useSSL=true\&requireSSL=true 3. jdbc:mysql://ip:port/databaseName?useUnicode=true\&characterEncoding=UTF-8\&allowPublicKeyRetrieval=true 4. jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/mysql?useUnicode=true\&characterEncoding=UTF-8 5. jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/mysql?useUnicode=true\&characterEncoding=UTF-8\&useSSL=true\&requireSSL=true 6. jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/mysql?useUnicode=true\&characterEncoding=UTF-8\&allowPublicKeyRetrieval=true 说明： - 连接字符串，需使用标准的JDBC连接源数据库。 - Microsoft SQL Server 为源数据库时，仅能选择"服务名称"或"数据源信息"进行连接。 | | 用户名 | **source_user_01** | 源数据库的用户名，最多128个字符。建议连接用户应具有管理员角色，但不要使用sys用户。 请输入由字母、数字、.、_、-、$、#组成，长度是2-128个字符，必须以字母、数字、.、_、-开头且允许使用"包裹的用户名。 | | 密码 | **Pass@worD#?** | 源数据库的有效密码，最多50个字符。 | | SSL类型 | **不使用 SSL** | 当前"单向SSL"连接不可用，请选择"不使用SSL"进行连接。 - 不使用SSL：如果不启用SSL安全协议，数据安全可能存在潜在风险。 - 单向SSL：将对数据库身份进行认证并启用安全加密传输。 - 上传文件：上传JKS类型的根证书文件。 - 信任密码：用于访问证书的信任库密码。 说明： - SSL（Secure Socket Layer，安全套接层），位于可靠的面向连接的网络层协议和应用层协议之间的一种协议层。SSL通过互相认证、使用数字签名确保完整性、使用加密确保私密性，以实现客户端和服务器之间的安全通讯。如果不启动SSL安全连接，请自行承担数据安全风险。 - Oracle-10g/11g为源库时，不支持单向SSL连接。 - PostgreSQL为源库时，仅支持上传PEM类型的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)。 | 表2选择评估范围参数说明 | **参数** | **示例** | **说明** | |:---|:---|:---| | 选择需采集的对象类型 | **全选** | 默认"全选"，也可依据实际情况手动勾选需采集的对象类型。 说明： 当源库类型为MySQL且版本在8.0以下时，MySQL不支持ROLE对象的创建，所以UGO不采集ROLE对象。 当源库为GoldenDB时，GoldenDB不支持ROLE对象的创建，所以UGO不采集ROLE对象。 当源库为DDM时，权限对象由DDM管理，所以UGO不采集ROLE对象。 | | 选择目标数据库 | **GaussDB 集中式版（A兼容） V2.0-8.200 企业版** | 依据实际情况，勾选所需的目标数据库类型作为目标数据库。也可全选，单击![](https://support.huaweicloud.com/qs-ugo/zh-cn_image_0000001994503626.png)。 若您确定某个数据库不作为目标数据库，可不将其作为选定的目标数据库，该数据库将不参与评估。 | | 选择需采集的Schema | **schema_01** | 依据实际情况手动勾选需采集的 Schema，可搜索也可全选，单击![](https://support.huaweicloud.com/qs-ugo/zh-cn_image_0000002030823405.png)。 若 Schema 较多，可依据 Schema 名称进行搜索。所选 Schema 信息及总数会显示在右侧。 须知： - 如果有多个具有相同名称（忽略大小写）的 Schema，请选择其中一个。 - 采集的 Oracle Lightweight Jobs 将作为 PROGRAM 对象类型。 | 表3高级配置参数说明 | 参数 | **示例** | **说明** | |:---|:---|:---| | 目标数据库评估 | **跳过目标数据库评估** | 设置评估项目是否进行目标数据库评估。默认不勾选"跳过目标数据库评估"。 - 勾选"跳过目标数据库评估"： UGO仅采集源数据库数据，但不评估目标数据库，在"目标数据库分析"页签将仅显示目标数据库选择，因此不会生成目标数据库的评估报告。建议在已确定要迁移的目标数据库时选择。 - 不勾选"跳过目标数据库评估"： 从源数据库采集数据后，目标数据库的评估和分析需要一些时间，生成目标数据库的评估报告。 - 若成功创建评估项目后需要再次打开评估功能，可在评估项目列表的操作列选择"重新评估"，重新评估后，在"目标数据库分析"页签中可参考[查看数据库评估结果](https://support.huaweicloud.com/qs-ugo/ugo_02_0008.html)查看目标数据库评估结果。此时也可以单击"重新评估"按钮进行部分对象的评估。 | | 动态SQL评估 | **打开** | 设置评估项目是否针对动态SQL进行评估。默认勾选"打开"。 - 勾选"打开"：分析对象中包含的动态SQL，生成报告。 - 取消勾选"打开"：不对动态SQL进行分析。 |