调用AlterTable修改表的数据库名、表名、表属性以及列信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AlterTable |
系统规定参数。取值:AlterTable。 |
OldDbName | String | 是 | oldDb001 |
旧数据库的名称。 |
OldTableName | String | 是 | oldTbl001 |
旧表的名称。 |
NewDbName | String | 是 | newDb001 |
新数据库的名称,可以和旧数据库名称一样,代表不修改数据库名。 |
NewTableName | String | 是 | newTbl001 |
新表的名称,可以和旧表名称一样,代表不修改表名。 |
Parameters | Map | 否 |
表属性。 |
|
String | 否 | key001=value001 |
表属性。 |
|
Col | Array | 是 |
列信息。 |
|
Comment | String | 否 | this is comment |
列注释。 |
Name | String | 是 | new_col1 |
列名称。 |
Type | String | 是 | int |
列类型。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | NO_SUCH_OBJECT |
标记错误的CODE。 |
Data | Boolean | false |
标记修改表是否成功。 |
Message | String | No such database: bd001 |
如果有错误,则返回错误的信息。 |
RequestId | String | 9BEAC206-0795-4DE3-B1FD-964BEF432B23 |
本次请求的RequestId。 |
Success | Boolean | true |
本次请求是否成功。 |
示例
请求示例
http(s)://[Endpoint]/?Action=AlterTable
&OldDbName=oldDb001
&OldTableName=oldTbl001
&NewDbName=newDb001
&NewTableName=newTbl001
&Parameters={"key":"key001=value001"}
&Col=[{"Comment":"this is comment","Name":"new_col1","Type":"int"}]
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<Message>No such database: bd001</Message>
<RequestId>9BEAC206-0795-4DE3-B1FD-964BEF432B23</RequestId>
<Data>false</Data>
<Code>NO_SUCH_OBJECT</Code>
<Success>true</Success>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Message" : "No such database: bd001",
"RequestId" : "9BEAC206-0795-4DE3-B1FD-964BEF432B23",
"Data" : "false",
"Code" : "NO_SUCH_OBJECT",
"Success" : "true"
}
错误码
访问错误中心查看更多错误码。