检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
UGO，以下简称为UGO）支持将本地Oracle数据库的结构迁移至华为云云数据库 GaussDB实例。通过UGO评估任务与迁移任务，帮助用户提前识别迁移适配点，提升迁移效率，最大化降低用户的数据库迁移成本。 本实践案例主要介绍了通过UGO将本地Oracle-11g数据库结构迁移至华为云云数据库 GaussDB 分布式版-2
自动转换为华为云GaussDB/RDS的SQL语法，通过数据库评估、结构迁移两大核心功能和自动化语法转换，提前识别可能存在的改造工作、提高转化率、最大化降低用户数据库迁移成本。 您可以使用本文档提供的API对UGO进行相关操作。支持的全部操作请参见API接口概览。 在调用UGO
基本概念 源数据库 指需要迁移的数据库，可简称为源库。 目标数据库 指接收迁移数据的华为云GaussDB/RDS数据库，可简称为目标库。 兼容性分析 基于源库的全量语法树，分析源库和目标库的语法差异点，形成语法差异知识库，以此来评估源库对象迁移到目标库的语法兼容度和迁移成功率。 数据库评估
图1 查询SQL中无order by 问题原因 GaussDB 分布式数据中，数据是按照分布键均匀存储在各DN节点上，select查询无order by时，数据随机从DN节点上读取，因此数据结果无法保证一致。 解决办法 查询的SQL语句中添加order by排序，order by排序的列为分布键。
SQL语句转换 操作场景 用户单独查看某个具体SQL语句在源库与目标库中是否支持转换，以及转换后的SQL语句。 前提条件 提供给UGO的SQL文本内容应语法正确、在源数据库上可成功编译且文本内容不超过100000个字符。 冻结账户无法查看和修改目标库类型以及转换配置。 操作步骤 登录UGO控制台。
在对象迁移页面，单击待迁移项目的“操作 > 迁移”。 在迁移计划页面，显示待迁移项目采集对象及分类。具体对象信息详见查看数据库评估结果。 图1 转换计划 用户密码： 如果要转换数据库对象USER，必须设置密码才能完成转换。设置的密码将用于目标数据库上创建的所有用户对象，迁移后需要逐一手动修改
UGO在使用上有一些功能约束与限制，具体见表1。 表1 功能约束与限制 功能 使用限制 对象采集范围 只采集用户业务相关的数据库对象，系统对象不采集，具体参见《 使用指导书》的常见问题：源数据库忽略迁移的schema有哪些？ 对源库的影响 UGO会占用一些数据库会话连接，在进行对
建的迁移项目“查看权限检查报告”按钮将被禁用。 说明： 要在目标库上创建对象，用户需要具有一些数据库权限，例如：创建表、创建函数等。如果跳过权限检查，则不检查用户是否具有这些权限。 但是，在迁移中，当在目标数据库上执行转换的sql时，可能都会由于缺乏权限而迁移失败。 选择评估项目
系统模板：系统自带模板，显示基础信息和启动规则。 仅允许查看各规则详情，包括规则名称、说明、适用数据库以及审核对象类型等，但不允许修改。可单击“上一条”或“下一条”切换查看。 自定义模板：显示基础信息和启动规则，所有用户均可对同一模板进行新增规则、修改或删除已有规则。 单击可修改描述，最多填写100个字符。
端节点服务。 创建VPC终端节点服务不收取任何费用。UGO会为创建的VPC终端节点服务添加白名单权限控制，确保您目标库的连接安全，您也可以在VPC终端节点服务页面看到目标库相应的终端节点服务。为了保证UGO功能使用正常，请不要在迁移项目未结束时删除目标库对应的VPC终端节点服务。
建的迁移项目“查看权限检查报告”按钮将被禁用。 说明： 要在目标库上创建对象，用户需要具有一些数据库权限，例如：创建表、创建函数等。如果跳过权限检查，则不检查用户是否具有这些权限。 但是，在迁移中，当在目标数据库上执行转换的SQL时，可能都会由于缺乏权限而迁移失败。 选择评估项目
当待转换对象中包含user对象时，需要为用户设置统一的密码。单击左上角“用户密码”，在弹窗中完成设置。 图2 用户密码 如果要转换数据库对象user，必须设置密码才能完成转换。设置的密码将用于目标数据库上创建的所有用户对象，迁移后需要逐一手动修改用户的密码。若不转换数据库对象USER
对于已成功关联企业项目的用户，仅需在“企业项目”下拉框中选择目标项目。 如果需要自定义企业项目，请前往项目管理服务进行创建。关于如何创建项目，详见《项目管理用户指南》。 目标数据库评估（可选） 跳过目标数据库评估： UGO采集数据，但不评估目标数据库，在查看数据库评估结果中目标数据库
步骤四：对象校正 修改后的语句将直接在目标数据库上运行，您需避免使用：导致其他表和其他对象类型丢失的语句，以及影响目标数据库性能的语句，如消耗过多CPU或内存的语句。 校正转换失败对象 登录UGO控制台。 单击左侧导航栏“结构迁移 > 对象迁移”，显示迁移项目列表。 单击待迁移项目的“操作
目标库的评估和分析，不生成评估报告，在查看数据库评估结果中目标数据库分析页签将仅显示目标数据库选择。建议在已确定要迁移的目标数据库时选择。 若成功创建评估任务后需要再次打开评估功能，可在评估项目列表中下拉选择“重新评估”。在重新评估后，才可以在查看数据库评估结果时，查看目标数据库评估结果。
请查看表3。若在创建评估项目-步骤9中取消勾选“跳过目标数据库评估”，页面如图所示： 图5 目标数据库分析页面 根据目标数据库分析结果，在目标数据库列表中单击要迁移的目标数据库前的单选框，并单击“确认数据库选择”完成数据库评估流程。 目标数据库确认后将无法修改。 页面功能说明 表1
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
