创建数据库评估项目
本章节介绍如何创建数据库评估项目,并选定目标库。
操作步骤
- 登录UGO控制台。
- 单击左侧导航栏 。
- 在评估数据库页面,单击右上角的“创建项目”。
- 进入基本信息页面,完成基本信息的填写。具体参数详见表1。
基本信息填写完成后,“开始测试”高亮显示。图1 创建评估项目
表1 基本详情参数说明 参数名称
说明
项目名称
在项目列表中显示的名称,这里命名为Oracle-GaussDB。
长度范围为5到50个字符,只允许包含英文字母、数字、下划线、中划线。以字母开头、数字或字母结束。
异常通知方式(可选)
默认方式为SMN主题。
若出现异常情况,是否通过消息通知服务(Simple Message Notification)向用户发送消息。
若需要发送消息,需要先创建SMN主题,具体请参见创建主题。
说明:后续操作:
创建完主题后,您就可以添加订阅了。完成创建和添加订阅后,后续的告警通知即可通过SMN服务发送到您配置的订阅终端。
源数据库类型
选择 Oracle 为源数据库类型。
数据库连接方式
用于选择连接源数据库的方式。默认选择“公网”。
选择“公网”,则通过弹性公网 IP(Elastic IP,EIP)连接源数据库。可选择通过“服务名称”或“连接字符串”连接源数据库。
- 如果源库网络有 IP 白名单限制,请将弹性公网 IP 添加至源库网络白名单,确保 UGO 可以连接源库。
- 亚太-新加坡弹性公网 IP:110.238.109.54
- 拉美-圣地亚哥弹性公网 IP:159.138.116.198
选择“终端节点服务”,则需要选择“终端节点服务”实例,以及“端口映射”。
- 单击“查看终端节点服务”,可跳转至终端节点服务管理界面,查看当前终端节点列表。
- 如何配置终端节点服务,请参考使用终端节点服务连接数据库。
连接方法
(“数据库连接方式”选择“公网”时需要设置)
当“数据库连接方式”选择“公网”时,需要设置“连接方法”。可选择“服务名称”或“连接字符串”。默认选择“服务名称”。
选择“服务名称”时,需填写“源数据库名称”、“主机端口”,并选择填写“主机IP地址”或“主机名”信息。
- “源数据库名称”用于输入待评估数据库的名称,需要满足以下规则:
- 由字母、数字、.、_、-、$、#组成。
- 长度是2-128个字符。
- 必须以字母、数字、.、_、-开头且允许使用引号(")包裹的名称。
说明:当 MySQL 为源数据库时,不显示该参数。
- “主机端口”用于输入待评估数据库开放的通讯端口,端口范围为 1-65535。
- 选择“主机IP地址”,需要填写具体源库“主机IP地址”。不支持IPv6格式的主机IP地址。
- 选择“主机名”,则需要填写“主机名”。
- 主机名不能为空。
- 支持多个主机名,总长度不超过 1024 位,各个主机名之间用英文逗号分隔。
- 单个主机名长度不超过 253 位,不允许包含以下特殊符号'!', '@', '#', '$', '%', '^', '&', '*', '(', ')', '+', '=', '[', ']', '{', '}', '|', '\', ':', ';', '<', '>', ',', '?', '/'。
选择“连接字符串”时,需填写“连接字符串”信息,各数据库连接字符串格式不同,以下格式供参考。
- Oracle:
兼容 IPv4 的 JDBC 格式:
- ip:port:databaseName
- ip:port/databaseName
- jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=ip)(PORT=port)))(CONNECT_DATA=(SERVICE_NAME=databaseName)))
- jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCPS)(HOST=ip)(PORT=port)))(CONNECT_DATA=(SERVICE_NAME=databaseName)))
- MySQL:
兼容 IPv4 的 JDBC 格式:
- jdbc:mysql://ip:port/databaseName?useUnicode=true&characterEncoding=UTF-8
- jdbc:mysql://ip:port/databaseName?useUnicode=true&characterEncoding=UTF-8&useSSL=true&requireSSL=true
- jdbc:mysql://ip:port/databaseName?useUnicode=true&characterEncoding=UTF-8&allowPublicKeyRetrieval=true
- jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true&characterEncoding=UTF-8
- jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true&characterEncoding=UTF-8&useSSL=true&requireSSL=true
- jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true&characterEncoding=UTF-8&allowPublicKeyRetrieval=true
- PostgreSQL:
- jdbc:postgresql://ip:port/databaseName
- GoldenDB:
兼容 IPv4 的 JDBC 格式:
- jdbc:mysql://ip:port/databaseName?useUnicode=true&characterEncoding=UTF-8
- jdbc:mysql://ip:port/databaseName?useUnicode=true&characterEncoding=UTF-8&useSSL=true&requireSSL=true
- jdbc:mysql://ip:port/databaseName?useUnicode=true&characterEncoding=UTF-8&allowPublicKeyRetrieval=true
- jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true&characterEncoding=UTF-8
- jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true&characterEncoding=UTF-8&useSSL=true&requireSSL=true
- jdbc:mysql://address=(protocol=tcp)(host=ip)(port=port)/databaseName?useUnicode=true&characterEncoding=UTF-8&allowPublicKeyRetrieval=true
说明:- 连接字符串,需使用标准的JDBC连接源数据库。
- Microsoft SQL Server 为源数据库时,仅能选择“服务名称”进行连接。
用户名
源数据库的用户名。建议连接用户应具有管理员角色,但不要使用sys用户。
密码
源数据库的有效密码,最多50个字符。
SSL类型(可选)
当前“单项SSL”连接不可用,请选择“不使用SSL”进行连接。
- 不使用SSL:如果不启用SSL安全协议,数据安全可能存在潜在风险。
- 单项SSL:将对数据库身份进行认证并启用安全加密传输。
- 上传文件:上传JKS类型的根证书文件。
- 信任密码:用于访问证书的信任库密码。
说明:- 若选择“单项SSL”,必须同时正确选择上传文件、填写信任密码,这些信息为用户私有。
- SSL(Secure Socket Layer,安全套接层),位于可靠的面向连接的网络层协议和应用层协议之间的一种协议层。SSL通过互相认证、使用数字签名确保完整性、使用加密确保私密性,以实现客户端和服务器之间的安全通讯。
标签(可选)
可使用TMS的预定义标签功能将相同的标签添加到不同的云资源中。具体请查看标签管理服务 TMS。
输入一对一的“键”和“值”后单击“添加”。
最多可添加20个标签。具体操作详见标签。
- 如果源库网络有 IP 白名单限制,请将弹性公网 IP 添加至源库网络白名单,确保 UGO 可以连接源库。
- 单击“开始测试”。
- 测试连接成功:“下一步”按钮高亮显示。
- 测试连接失败:给出错误提示“无法连接到数据库”。
- (可选项)测试网络稳定性。测试网络稳定性成功仅表示当前测试时网络时延低,无丢包或丢包率很低。需要10到15s。
- 单击“下一步”,进入预检查页面。
显示各检查项的检查结果。也可“重新检查所有权限”。图2 Oracle 为源库预检查
若存在失败项,单击“查看详情”,参考解决方案进行修改后“重新验证”。
- 所有结果均成功后,单击“下一步”。进入选择评估范围页面。
图3 选择评估范围
表2 选择评估范围参数说明 参数
说明
选择需采集的对象类型
默认“全选”,也可依据实际情况手动勾选需采集的对象类型。
选择目标数据库
选择“GaussDB 分布式版(ORA 兼容)V2.0-8.100 企业版”作为目标库。
选择需采集的 Schema
依据实际情况手动勾选需采集的 Schema,可搜索也可全选,单击
。
若 Schema 较多,可依据 Schema 名称进行搜索。所选 Schema 信息及总数会显示在右侧。
须知:- 如果有多个具有相同名称(忽略大小写)的 Schema,请选择其中一个。
- 采集的 Oracle Lightweight Jobs 将作为 PROGRAM 对象类型。
- 程序只会采集用户权限范围内的数据库对象,即勾选的 Schema。
- 源库对象类型用于数据库评估兼容性分析和对象迁移。
- 所有采集的数据存储在租户区的源数据库中,数据库密码会加密存储,相关数据只有用户在 UGO 界面可见。
- 当用户删除迁移任务以及注销 UGO 时,用户数据将被删除。
- 选择完成后,单击“下一步”,进入任务确认页面。
显示基础信息、预检查情况、选定的目标数据库、已选择及未选择的 Schema 和对象类型。图4 任务确认
- 检查无误后,单击“创建”。显示“项目创建成功!”。
- 单击“确定”,返回数据库评估页面,用户可以看到最新创建的评估项目已在列表中。
需要经过数据采集、项目评估和预迁移评估,可在“项目状态”中查看实时状态。图5 创建成功
- “项目状态”为“评估-成功 待确认目标数据库”之前,可停止及恢复正在创建的评估项目。当“项目状态”为“评估-成功 待确认目标数据库”时,可直接确认目标库,也可以“重新评估”。
- 等待时间依据所选对象数量而定。
- 评估完成后,可单击具体“项目名称”,查看数据库评估结果。
- 数据采集过程中,如果与源数库的连接中断,系统内部的自动重试机制会定期测试其与源数据库的连接,并重试连接。下次重试连接时间:当前时间 + 检查测试连接和网络稳定性连接所需的时间 + 重试睡眠间隔。每次检查测试连接和网络稳定性连接所需的时间有几秒的误差。因此,用户可能会看到两个重试时间之前相差几秒。
- 当“项目状态”为“评估-成功 待确认目标数据库”时,单击“项目名称”或“项目状态”列的“待确认目标数据库”。
- 进入目标数据库分析页面,选中“GaussDB 分布式版(ORA 兼容)V2.0-8.100 企业版”,单击“确认数据库选择”按钮。
- 确认目标库选择后单击“确认”。
- 目标数据库确认后,弹出提示框。
- 立即创建:页面跳转至创建迁移项目信息填写页面,可直接创建迁移项目。
- 稍后创建:不进行页面跳转,仍停留在“目标数据库分析”页签。
后续操作
您可在查看数据库评估结果中查看评估项目的具体信息。