批量新增数据湖的元数据表

调试

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

请求头

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

请求语法

POST /api/metastore/catalogs/databases/tables/batchcreate 

请求参数

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

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

CatalogId String Body 1344371

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

DatabaseName String Body database_test

元数据库名称

IfNotExists Boolean Body true

如果相同名字的表已经存在,是否忽略异常

TableInputs Array of TableInput Body

元数据表列表

RegionId String Host cn-hangzhou

系统所在的地域ID

返回数据

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

状态码描述

Message String .

提示相关错误信息

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

请求ID

Success Boolean true

是否成功

TableErrors Array of TableError

创建Table的错误信息

Code错误码说明

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

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

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

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

示例

请求示例

POST /api/metastore/catalogs/databases/tables/batchcreate HTTP/1.1 
 {
  "CatalogId": "1344371",
  "DatabaseName": "database_test",
  "IfNotExists": true,
  "TableInputs": [{
    "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 格式

{
    "Message": "",
    "RequestId": "B7F4B621-E41E-4C84-B97F-42B5380A32BB",
    "TableErrors": [],
    "Code": "OK",
    "Success": "true"
}

错误码

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

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