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

在指定的 Hive 資料表中建立多個分區。

HTTP 要求


POST https://biglake.googleapis.com/hive/v1/{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)

這是必要旗標,要新增的分區。