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

Ajoute des partitions à une table.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Référence à la table à laquelle les partitions doivent être ajoutées, au format projects/{project}/catalogs/{catalogs}/databases/{database}/tables/{table}.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "requests": [
    {
      object (CreatePartitionRequest)
    }
  ],
  "skipExistingPartitions": boolean
}
Champs
requests[]

object (CreatePartitionRequest)

Obligatoire. Demandes d'ajout de partitions à la table.

skipExistingPartitions

boolean

Facultatif. Correspond à l'indicateur ifNotExists dans les API Hive Metastore. Si le flag est défini sur "false", le serveur renvoie ALREADY_EXISTS si une partition existe déjà. Si l'indicateur est défini sur "true", le serveur ignore les partitions existantes et n'insère que les partitions inexistantes. Vous pouvez insérer jusqu'à 900 partitions dans un lot.

Corps de la réponse

Message de réponse pour partitions.batchCreate.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "partitions": [
    {
      object (Partition)
    }
  ]
}
Champs
partitions[]

object (Partition)

Liste des partitions ajoutées.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.

CreatePartitionRequest

Message de requête pour CreatePartition. La partition est identifiée de manière unique par des valeurs, qui constituent une liste ordonnée. Il n'existe donc pas de champ distinct pour le nom ou l'ID de partition.

Représentation JSON
{
  "parent": string,
  "partition": {
    object (Partition)
  }
}
Champs
parent

string

Obligatoire. Référence à la table à laquelle la partition doit être ajoutée, au format projects/{project}/catalogs/{catalogs}/databases/{databases}/tables/{table}.

partition

object (Partition)

Obligatoire. Partition à ajouter.