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

Adiciona partições a uma tabela.

Solicitação HTTP


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

Os URLs usam 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 à flag ifNotExists nas APIs do Hive Metastore. Se a flag for definida como "false", o servidor vai retornar "ALREADY_EXISTS" se alguma partição já existir. Se a flag for definida 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 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 de forma exclusiva por valores, que é uma lista ordenada. Portanto, não há um campo separado de nome ou ID da 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.