创建 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"
}

错误码

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