创建 OSS 的表

请求参数

名称 类型 是否必选 示例值 描述
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]/?TableName=tbl001
&ViewOriginalText=select count(*) from tbl001
&Parameters={"key":"key001=value001"}
&TableType=VIEW
&ViewExpandedText=select count(*) from tbl001
&StorageDescriptor={"Cols":[{"PARAM_KEY":{"Comment":"this is column comment","Type":"string","Name":"col1"}}],"Parameters":{"key":"key001=value001"},"InputFormat":"org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat","SerDeInfo":{"SerializationLib":"org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe","Parameters":{"key":"key001=value001"},"Name":"serDename"},"OutputFormat":"org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat","Location":"oss://data/warehouse/tblname"}
&DbName=db001
&PartitionKeys=[{"PARAM_KEY":{"Comment":"this is partition keys","Type":"string","Name":"part_id001"}}]
&公共请求参数

正常返回示例

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 格式

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

错误码

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