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

Fügt einer Tabelle Partitionen hinzu.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Verweis auf die Tabelle, der die Partitionen hinzugefügt werden sollen, im Format „projects/{project}/catalogs/{catalogs}/databases/{database}/tables/{table}“.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requests": [
    {
      object (CreatePartitionRequest)
    }
  ],
  "skipExistingPartitions": boolean
}
Felder
requests[]

object (CreatePartitionRequest)

Erforderlich. Anfragen zum Hinzufügen von Partitionen zur Tabelle.
skipExistingPartitions

boolean

Optional. Entspricht dem Flag ifNotExists in den Hive-Metastore-APIs. Wenn das Flag auf „false“ gesetzt ist, gibt der Server ALREADY_EXISTS zurück, wenn eine Partition bereits vorhanden ist. Wenn das Flag auf „true“ gesetzt ist, überspringt der Server vorhandene Partitionen und fügt nur die nicht vorhandenen Partitionen ein. In einem Batch können maximal 900 Partitionen eingefügt werden.

Antworttext

Antwortnachricht für „partitions.batchCreate“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "partitions": [
    {
      object (Partition)
    }
  ]
}
Felder
partitions[]

object (Partition)

Die Liste der hinzugefügten Partitionen.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

CreatePartitionRequest

Anfragenachricht für CreatePartition. Die Partition wird eindeutig durch Werte identifiziert, die eine geordnete Liste bilden. Daher gibt es kein separates Feld für den Namen oder die Partitions-ID.

JSON-Darstellung 
{
  "parent": string,
  "partition": {
    object (Partition)
  }
}
Felder
parent

string

Erforderlich. Verweis auf die Tabelle, der die Partition hinzugefügt werden soll, im Format „projects/{project}/catalogs/{catalogs}/databases/{databases}/tables/{table}“.
partition

object (Partition)

Erforderlich. Die hinzuzufügende Partition.