接口功能介绍
创建DDL任务。请输入正确且支持的sQL语句。SQL语法目前支持create(建表)、alter(修改表结构)、drop(删除表)、设置分片规则、添加序列和删除序列等六种类型的SQL,其他类型的SQL会提示失败。单个任务SQL条数最大为1000,超过会提示失败。当前有DDL任务正在执行时提交会提示失败。请注意SQL语句满足DDL审计规则。
接口约束
请先订购DRDS实例。请先订购和DRDS实例在一个资源池同一个VPC下的RDS-MySQL实例,并关联DRDS实例中。请先创建一个schema、table。
URI
POST /v2/ddl-task/create
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
prodInstId | 是 | String | DRDS产品实例id | a15838ebf80644d7aa07e39a3905eead | |
sehemaName | 是 | String | schema名称 | sc1 | |
script | 是 | String | sql语句,支持多条,每条用分号分割。 | create table t111(id int not null primary key) | |
ignoreError | 否 | Boolean | 遇到错误是否继续执行。null则默认false | false |
响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
code | 是 | String | 返回码 取值范围:0表示成功,1表示失败 | 0 | |
message | 是 | String | 结果描述 | success | |
result | 否 | Long | 创建成功返回任务id。 |
请求示例
请求头header
无
请求体body
{
"prodInstId":"a15838ebf80644d7aa07e39a3905eead",
"schemaName":"sc1",
"script":"create table t111(id int not null primary key)",
"ignoreError": false
}
响应示例
{
"code": 0,
"message": "success",
"result": 115
}
状态码
请参考 状态码说明。