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

Adiciona partições a uma tabela.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Referência à tabela em que as partições serão adicionadas, no formato projects/{project}/catalogs/{catalogs}/databases/{database}/tables/{table}.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "requests": [
    {
      object (CreatePartitionRequest)
    }
  ],
  "skipExistingPartitions": boolean
}
Campos
requests[]

object (CreatePartitionRequest)

Obrigatório. Solicitações para adicionar partições à tabela.
skipExistingPartitions

boolean

Opcional. Corresponde ao flag ifNotExists nas APIs do Hive Metastore. Se o flag estiver definido como "false", o servidor retornará ALREADY_EXISTS se alguma partição já existir. Se o flag estiver definido como "true", o servidor vai ignorar as partições atuais e inserir apenas as que não existem. É possível inserir no máximo 900 partições em um lote.

Corpo da resposta

Mensagem da resposta para partitions.batchCreate.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "partitions": [
    {
      object (Partition)
    }
  ]
}
Campos
partitions[]

object (Partition)

A lista de partições que foram adicionadas.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

CreatePartitionRequest

Mensagem de solicitação para CreatePartition. A partição é identificada exclusivamente por valores, que é uma lista ordenada. Portanto, não há um nome separado ou um campo de ID de partição.

Representação JSON 
{
  "parent": string,
  "partition": {
    object (Partition)
  }
}
Campos
parent

string

Obrigatório. Referência à tabela em que a partição será adicionada, no formato projects/{project}/catalogs/{catalogs}/databases/{databases}/tables/{table}.
partition

object (Partition)

Obrigatório. A partição a ser adicionada.