调用CreateTable创建OSS的表_云原生数据湖分析 DLA - 文档停止维护-阿里云帮助中心

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	CreateTable	系统规定参数。取值：CreateTable。
DbName	String	是	db001	数据库的名称。
TableName	String	是	tbl001	需要创建的表名。
PartitionKeys	Array	否		分区字段信息，可选参数。
Comment	String	否	this is partition keys	分区注释。
Name	String	是	part_id001	分区的列名。
Type	String	是	string	分区列类型。
Parameters	Map	否		表属性。
	String	否	key001=value001	表属性。
StorageDescriptor	Object	是		表的存储描述信息。
Cols	Array	是		表的列信息。
Comment	String	否	this is column comment	表的列字段注释。
Name	String	是	col1	表的列名称。
Type	String	是	string	表的列类型。
InputFormat	String	是	org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat	表的InputFormat。
Location	String	是	oss://data/warehouse/tblname	表数据存储的目录。
OutputFormat	String	是	org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat	表的OutputFormat信息。
Parameters	Map	否		SD属性。
	String	否	key001=value001	SD属性。
SerDeInfo	Object	是		表的序列化和反序列信息。
Name	String	否	serDename	表的序列化和反序列化的名称。
Parameters	Map	否		表的序列化和反序列化的属性。
	String	否	key001=value001	表的序列化和反序列化的属性。
SerializationLib	String	是	org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe	表的序列化和反序列化的类库。
ViewOriginalText	String	否	select count(*) from tbl001	视图的原始SQL。
ViewExpandedText	String	否	select count(*) from tbl001	视图的展开SQL。
TableType	String	是	VIEW	表的类型，比如VIEW、MANAGED_TABLE、EXTERNAL_TABLE、VIRTUAL_VIEW等。

返回数据


名称	类型	示例值	描述
Code	String	ALREADY_EXISTS	标记错误的Code。
Data	Long	1234	成功创建表时返回表的ID。
Message	String	Table db001.tbl001 already exists	如果创建表出错，返回错误的详细信息。
RequestId	String	9BEAC206-0795-4DE3-B1FD-964BEF432B23	本次请求的RequestId。
Success	Boolean	false	标记本次请求是否成功。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateTable
&DbName=db001
&TableName=tbl001
&PartitionKeys=[{"Comment":"this is partition keys","Name":"part_id001","Type":"string"}]
&Parameters={"key":"key001=value001"}
&StorageDescriptor={"Cols":[{"Comment":"this is column comment","Name":"col1","Type":"string"}],"InputFormat":"org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat","Location":"oss://data/warehouse/tblname","OutputFormat":"org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat","Parameters":{"key":"key001=value001"},"SerDeInfo":{"Name":"serDename","Parameters":{"key":"key001=value001"},"SerializationLib":"org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe"}}
&ViewOriginalText=select count(*) from tbl001
&ViewExpandedText=select count(*) from tbl001
&TableType=VIEW
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<Message>Table db001.tbl001 already exists</Message>
<RequestId>9BEAC206-0795-4DE3-B1FD-964BEF432B23</RequestId>
<Data>1234</Data>
<Code>ALREADY_EXISTS</Code>
<Success>false</Success>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Message" : "Table db001.tbl001 already exists",
  "RequestId" : "9BEAC206-0795-4DE3-B1FD-964BEF432B23",
  "Data" : "1234",
  "Code" : "ALREADY_EXISTS",
  "Success" : "false"
}

错误码

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