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

Aggiunge partizioni a una tabella.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Riferimento alla tabella a cui aggiungere le partizioni, nel formato projects/{project}/catalogs/{catalogs}/databases/{database}/tables/{table}.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "requests": [
    {
      object (CreatePartitionRequest)
    }
  ],
  "skipExistingPartitions": boolean
}
Campi
requests[]

object (CreatePartitionRequest)

Obbligatorio. Richieste di aggiunta di partizioni alla tabella.

skipExistingPartitions

boolean

Facoltativo. Corrisponde al flag ifNotExists nelle API Hive Metastore. Se il flag è impostato su false, il server restituirà ALREADY_EXISTS se esiste già una partizione. Se il flag è impostato su true, il server ignorerà le partizioni esistenti e inserirà solo quelle non esistenti. In un batch è possibile inserire un massimo di 900 partizioni.

Corpo della risposta

Messaggio di risposta per partitions.batchCreate.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "partitions": [
    {
      object (Partition)
    }
  ]
}
Campi
partitions[]

object (Partition)

L'elenco delle partizioni aggiunte.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la Authentication Overview.

CreatePartitionRequest

Messaggio di richiesta per CreatePartition. La partizione è identificata in modo univoco dai valori, che sono un elenco ordinato. Pertanto, non esiste un campo separato per il nome o l'ID partizione.

Rappresentazione JSON
{
  "parent": string,
  "partition": {
    object (Partition)
  }
}
Campi
parent

string

Obbligatorio. Riferimento alla tabella a cui aggiungere la partizione, nel formato projects/{project}/catalogs/{catalogs}/databases/{databases}/tables/{table}.

partition

object (Partition)

Obbligatorio. La partizione da aggiungere.