文档首页/数据库和应用迁移 UGO/API参考/API/SQL语句转换/SQL语句转换
更新时间：2026-03-19 GMT+08:00
查看PDF
分享

SQL语句转换

功能介绍

SQL语句转换。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/sql-conversion

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的Project ID。

获取方法请参见获取项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

从IAM服务获取的用户Token。

表3 请求Body参数

参数

是否必选

参数类型

描述

source_db_type

是

String

源数据库类型。

枚举值：

  • Oracle
  • MySQL
  • GoldenDB
  • PostgreSQL
  • Microsoft SQL Server
  • Informix
  • MariaDB
  • openGauss

target_db_type

是

String

目标数据库类型。

枚举值：

  • GaussDB Centralized

  • GaussDB Distributed

  • GaussDB CloudNative(Centralized)
  • GaussDB CloudNative(Distributed)

  • GaussDB Centralized(M-Compatibility)

  • GaussDB Centralized(B-Compatibility)
  • GaussDB Distributed(MySQL-Compatibility)

  • RDS for PostgreSQL

  • RDS for MySQL
  • TaurusDB

target_db_version

是

String

目标数据库版本。

注意：

该字段需要与 target_db_type 字段组合成有效的目标数据库类型与版本。

  • GaussDB Centralized

    10.0、9.0、8.200、8.100、8.0、3.3、3.2、3.1、2.7

  • GaussDB Distributed

    9.0、8.200、8.100、8.0、3.3、3.2、3.1、2.7

  • GaussDB CloudNative(Centralized)

    10.0

  • GaussDB CloudNative(Distributed)

    10.0

  • GaussDB Centralized(M-Compatibility)

    10.0、9.0、8.200、8.100

  • GaussDB Centralized(B-Compatibility)

    10.0、8.200、8.100、8.0、3.3、3.2、3.1、2.7

  • GaussDB Distributed(MySQL-Compatibility)

    10.0、8.200、8.100、8.0、3.3、3.2、3.1、2.7

  • RDS for PostgreSQL

    11、12、13、14、15

  • RDS for MySQL

    5.7

  • TaurusDB

sql_statement

是

String

需要转换的SQL语句。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

is_support_conversion

Boolean

是否支持SQL语句转换。

converted_sql_statement

String

转换后的SQL语句。

unsupported_items

Array of 表5 objects

不支持SQL语句转换的详情。

表5 UnSupportedItem

参数

参数类型

描述

reason

String

SQL语句不支持转换的原因。

suggestion

String

SQL语句不支持转换的建议。

line_number

Integer

行号。

position

Integer

位置。

请求示例

创建源库为Oracle，目标库为RDS for PostgreSQL-11版本的SQL语句转换请求。

POST https://{EndPoint}/v1/{project_id}/sql-conversion 
 
{ 
  "source_db_type" : "ORACLE", 
  "target_db_type" : "RDS for PostgreSQL", 
  "sql_statement" : "create table ugo(col1 int, col2 varchar2);", 
  "target_db_version" : "11" 
}

响应示例

状态码： 200

请求成功。

{ 
  "converted_sql_statement" : "create table ugo(col1 NUMERIC(38), col2 VARCHAR);", 
  "is_support_conversion" : true 
}

状态码

状态码

描述

200

请求成功。

错误码

请参见错误码。

父主题：SQL语句转换

相关文档