Method: hive.v1beta.projects.catalogs.databases.tables.partitions.batchCreate

向表中添加分区。

HTTP 请求

POST https://biglake.googleapis.com/hive/v1beta/{parent=projects/*/catalogs/*/databases/*/tables/*}/partitions:batchCreate

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。对要添加分区的表的引用，格式为 projects/{project}/catalogs/{catalogs}/databases/{database}/tables/{table}。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "requests": [
    {
      object (CreatePartitionRequest)
    }
  ],
  "skipExistingPartitions": boolean
}
字段
requests[]

object (CreatePartitionRequest)

必需。向表中添加分区的请求。
skipExistingPartitions

boolean

可选。对应于 Hive Metastore API 中的 ifNotExists 标志。如果该标志设置为 false，则当任何分区已存在时，服务器将返回 ALREADY_EXISTS。如果该标志设置为 true，则服务器将跳过现有分区，仅插入不存在的分区。一个批次中最多可以插入 900 个分区。

响应正文

针对 partitions.batchCreate 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "partitions": [
    {
      object (Partition)
    }
  ]
}
字段
partitions[]

object (Partition)

已添加的分区列表。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

CreatePartitionRequest

针对 CreatePartition 的请求消息。分区由值（一个有序列表）唯一标识。因此，没有单独的名称或分区 ID 字段。

JSON 表示法 
{
  "parent": string,
  "partition": {
    object (Partition)
  }
}
字段
parent

string

必需。对要添加分区的表的引用，格式为 projects/{project}/catalogs/{catalogs}/databases/{databases}/tables/{table}。
partition

object (Partition)

必需。要添加的分区。