# SQL语句转换
#### 功能介绍
SQL语句转换。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=UGO&api=RunSqlConversion)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v1/{project_id}/sql-conversion
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                             |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户在某一Region下的Project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ugo/ugo_05_0025.html)。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 从IAM服务获取的用户Token。 |
   
表3请求Body参数 
| 参数                | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| source_db_type    | 是    | String | 源数据库类型。 枚举值： - Oracle  - MySQL  - GoldenDB  - PostgreSQL  - Microsoft SQL Server  - Informix  - MariaDB  - openGauss  - DDM                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 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语句转换的详情。 |
   
 表5UnSupportedItem 
| 参数          | 参数类型    | 描述             |
|:---|:---|:---|
| 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 | 请求成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ugo/ugo_05_0024.html)。