新增数据湖的元数据表

调试

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

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

POST /api/metastore/catalogs/databases/tables 

请求参数

名称 类型 位置 是否必选 示例值 描述
Object Body

HTTP 请求体(HTTP BODY)内容,均采用JSON格式

CatalogId String Body 1344371

数据库分类命名空间,默认填写主账号Uid

DatabaseName String Body database_test

元数据库名称

TableInput TableInput Body

元数据表详细信息

RegionId String Host cn-hangzhou

系统所在的地域ID

返回数据

名称 类型 示例值 描述
Code String OK

状态码描述

Message String .

提示相关错误信息

RequestId String B7F4B621-E41E-4C84-B97F-42B5380A32BB

请求ID

Success Boolean true

是否成功

Code错误码说明

InvalidObject:name/partition/column/skewCol 校验不通过

AlreadyExists:对应的元数据表已经存在

NoSuchObject:对应的元数据库不存在

InternalError:其他类型错误,请参考Message提示

示例

请求示例

POST /api/metastore/catalogs/databases/tables HTTP/1.1 
{
  "CatalogId": "1344371",
  "DatabaseName": "database_test",
  "TableInput": {
    "Cascade": false,
    "TableName": "test_table_20201223",
    "DatabaseName": "database_test",  
    "TableType": "MANAGED_TABLE",
    "Description": "",
    "Retention": 365,
    "Sd": {
      "Cols": [
        {
          "Comment": "user_name",
          "Name": "name",
          "Type": "string",
          "Parameters": {}
        }
      ],
      "Compressed": false,
      "InputFormat": "input",
      "Location": "",
      "NumBuckets": 5,
      "OutputFormat": "output",
      "Parameters": {},
      "SerDeInfo": {
        "Name": "",
        "SerializationLib": "",
        "Parameters": {}
      },
      "SkewedInfo": {
        "SkewedColNames": [],
        "SkewedColValues": [],
        "SkewedColValueLocationMaps": {}
      },
      "BucketCols": [
        "col1"
      ],
      "SortCols": [
        {
          "Order": 0,
          "Col": "col"
        }
      ],
      "StoredAsSubDirectories": false
    },
    "PartitionKeys": [
      {
        "Comment": "comment_day",
        "Name": "day",
        "Type": "int",
        "Parameters": {}
      }
    ],
    "Parameters": {},
    "ViewOriginalText": "",
    "ViewExpandedText": "",
    "RewriteEnabled": true,
    "Temporary": false
  }
}

正常返回示例

JSON 格式

{
  "Success": true,
  "Code": "OK",
  "Message": "",
  "HttpStatusCode": 200,
  "RequestId": "B7F4B621-E41E-4C84-B97F-42B5380A32BB"
}

错误码

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

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

注:表支持的数据格式

创建表时用户必须指定数据格式,参数示例如下

avro格式:

table.Parameters: {"classification":"avro"}

table.Sd:

"InputFormat":"org.apache.hadoop.hive.ql.io.avro.AvroContainerInputFormat"

"OutputFormat":"org.apache.hadoop.hive.ql.io.avro.AvroContainerOutputFormat"

"SerdeInfo":{"SerializationLib":"org.apache.hadoop.hive.serde2.avro.AvroSerDe","Parameters":{"serialization.format":"1"}}

json格式:

table.Parameters:{"classification":"json"}

table.Sd:

"InputFormat":"org.apache.hadoop.mapred.TextInputFormat"

"OutputFormat":"org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat"

"SerdeInfo":{"Parameters":{"paths":","},"SerializationLib":"org.apache.hive.hcatalog.data.JsonSerDe"}

xml格式

table.Parameters:{"classification":"json"}

"InputFormat":"com.ibm.spss.hive.serde2.xml.XmlInputFormat"

"OutputFormat":"org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat",

"SerdeInfo":{"Parameters":{"rowTag":""},"SerializationLib":"com.ibm.spss.hive.serde2.xml.XmlSerDe"}

parquet格式

table.Parameters:{"classification":"parquet"}

"InputFormat":"org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat"

"OutputFormat":"org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat"

"SerdeInfo":{"Parameters":{"serialization.format":"1"},"SerializationLib":"org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe"}

csv格式

table.Parameters:{"classification":"csv"}

"InputFormat":"org.apache.hadoop.mapred.TextInputFormat",

"OutputFormat":"org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat",

"SerdeInfo":{"Parameters":{"separatorChar":","},"SerializationLib":"org.apache.hadoop.hive.serde2.OpenCSVSerde"}

注意:separatorChar(分隔符)页面填的,比如“,” 逗号

orc格式

table.Parameters:{"classification":"orc"}

"InputFormat":"org.apache.hadoop.hive.ql.io.orc.OrcInputFormat",

"OutputFormat":"org.apache.hadoop.hive.ql.io.orc.OrcOutputFormat",

"SerdeInfo":{"Parameters":{},"SerializationLib":"org.apache.hadoop.hive.ql.io.orc.OrcSerde"}