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

テーブルにパーティションを追加します。

HTTP リクエスト

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

この URL では gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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)

必須。追加するパーティション。