调用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"
}

错误码

访问错误中心查看更多错误码。