检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
约束与限制 UGO在使用上有一些功能约束与限制,具体见表1。 表1 功能约束与限制 功能 使用限制 对象采集范围 只采集用户业务相关的数据库对象,系统对象不采集,具体参见《 使用指导书》的常见问题:源数据库忽略迁移的schema有哪些? 对源库的影响 UGO会占用一些数据库会话连
API接口概览 UGO目前开放的接口如下: 表1 接口类型及说明 类型 说明 API版本管理 查询API版本信息列表。 查询指定版本号的API版本信息。 SQL语句转换 实现源库与目标数据之间SQL语句的自动转换。 评估项目 实现评估项目的创建、查询项目详情、确认目标数据库类型等信息。
SQL语句转换 操作场景 用户单独查看某个具体SQL语句在源库与目标库中是否支持转换,以及转换后的SQL语句。 前提条件 提供给UGO的SQL文本内容应语法正确、在源数据库上可成功编译且文本内容不超过100000个字符。 冻结账户无法查看和修改目标库类型以及转换配置。 操作步骤 登录UGO控制台。
数字或者字母结束的唯一的任务名称。 数据库类型 GaussDB 下拉选择数据库类型。当前仅支持GaussDB数据库。必选。 数据源信息 app_db_01 下拉选择数据源,当前仅支持GaussDB。必选。 “创建数据源”可以快速跳转到数据源管理的地方进行创建需要的数据源信息。 schema信息
确认迁移结果 本章节以PROCEDURE对象类型为例说明如何确认迁移结果。 操作步骤 当迁移验证进度为100%后,可查看到PROCEDURE的迁移情况。 返回“对象校正”页签,选择PROCEDURE,查看各具体Schema的迁移情况。这里以PROC_REQ197为例。 单击迁移成
异常请求结果 下表描述异常参数。 表1 异常参数说明 参数 参数类型 描述 error_code String 提交任务异常时返回的错误编码。 error_msg String 提交任务异常时返回的错误描述信息。 响应示例: { "error_code": "UGO.1000"
参数名称 示例 说明 数据库类型 GaussDB 下拉选择数据库类型。当前仅支持GaussDB、MySQL和PostgreSQL。 数据源信息 app_db_01 下拉选择数据源,当前仅支持GaussDB、MySQL和PostgreSQL。 非必选,若不提供数据源,默认跳过依赖数据源的审核规则。
from e; 规则约束 所有涉及update、delete的规则项,均不支持多表操作审核。 update、delete多表操作仅支持规则项:“不应用单条update、delete语句对多个表实现更新、删除操作”。 对于“在PL/pgSQL中,关键字建议大写,非关键字小写”、“sql语句
合规说明 数据合规处理说明 UGO在完成其功能的过程中需要接触您的数据,包括数据库连接相关信息和源数据库结构信息,具体包括: 数据库连接相关信息:数据库IP、端口、数据库用户名、密码、SSL认证证书及证书密码等。 源数据库结构信息:UGO仅会访问和获取您的源库结构信息,不会获取源
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,状态码列表请参见状态码。 对于获取用户Token的接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息
获取帐号ID 在调用接口的时候,部分URL中需要填入账号ID(domain-id),所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下: 注册并登录管理控制台。 单击用户名,在下拉列表中单击“我的凭证”。 在“API凭证”页面的项目列表中查看账号ID。 图1 获取账号ID
调用说明 数据库和应用迁移 UGO提供了REST(Representational State Transfer)风格的API,支持通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
获取项目ID 从控制台获取项目ID 在调用接口的时候,部分URL中需要填入项目编号,所以需要获取到项目编号。项目编号获取步骤如下: 注册并登录管理控制台。 单击用户名,在下拉列表中单击“基本信息”。 在基本信息页面单击“管理我的凭证”。 在“API凭证”页面的项目列表中查看项目ID。
语法转换说明 日期时间函数转换说明 在使用 UGO 进行语法转换时,如果所选目标库为 GaussDB V2.0-3.2 或以下的版本,GaussDB 部分时间函数与事务相关详情可参见表1。这些函数返回的都是事务的开始时间,而在源库中获取的为系统当前时间,在长事务的场景下,源库和目标库
增量评估 当源库为Oracle和MySQL时,支持该功能。 当源库为MySQL时,暂不支持对USER、GRANT、ROLE进行增量采集。 前提条件 具有对应项目的操作权限。 有已创建但未进行目标数据库确认的评估项目。 项目源库存在新增内容,如新增table,function等信息。删除或修改已有内容,无法识别。
约束与限制 详细限制请参见具体API的说明。 父主题: 使用前必读
重新评估 前提条件 “项目状态”为“进行中 待确认目标数据库”。 被冻结的账号,不能使用该功能。 Microsoft SQL Server为源库不支持该功能。 操作场景 将对当前评估任务进行重新评估,包括动态SQL评估、工作量评估、对象转换统计、不兼容语法的TOP、系统对象。 操作步骤
推荐索引 操作场景 查看为审核文件中的SQL推荐的索引信息。 前提条件 目前仅支持为 GaussDB 推荐索引。 在创建审核文件任务时启用了“是否推荐索引”开关。 操作步骤 登录UGO控制台。 单击左侧导航栏“SQL审核 > 语句审核 > 审核文件”,进入审核文件页面。 在审核文
查询配额 功能介绍 查询单租户的配额,包括评估项目配额、迁移项目配额。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v1/{project_id}/quotas
删除规则模板 操作场景 删除已创建的自定义规则模板。删除后模板将无法恢复,请谨慎操作。 前提条件 存在已创建的自定义规则模板。 操作步骤 登录UGO控制台。 单击左侧导航栏“SQL审核 > 规则管理”,默认进入规则模板页面。 在列表中,选择待删除的自定义模板,单击“操作 > 删除”。