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)

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