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

Agrega particiones a una tabla.

Solicitud HTTP


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

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es la referencia a la tabla a la que se agregarán las particiones, con el formato projects/{project}/catalogs/{catalogs}/databases/{database}/tables/{table}.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "requests": [
    {
      object (CreatePartitionRequest)
    }
  ],
  "skipExistingPartitions": boolean
}
Campos
requests[]

object (CreatePartitionRequest)

Obligatorio. Son solicitudes para agregar particiones a la tabla.
skipExistingPartitions

boolean

Es opcional. Corresponde a la marca ifNotExists en las APIs de Hive Metastore. Si la marca se establece como falsa, el servidor devolverá ALREADY_EXISTS si ya existe alguna partición. Si la marca se establece en verdadero, el servidor omitirá las particiones existentes y solo insertará las que no existan. Se puede insertar un máximo de 900 particiones en un lote.

Cuerpo de la respuesta

Es el mensaje de respuesta de partitions.batchCreate.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "partitions": [
    {
      object (Partition)
    }
  ]
}
Campos
partitions[]

object (Partition)

Es la lista de particiones que se agregaron.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.

CreatePartitionRequest

Es el mensaje de solicitud para CreatePartition. La partición se identifica de forma única por valores, que es una lista ordenada. Por lo tanto, no hay un campo de nombre o ID de partición independiente.

Representación JSON 
{
  "parent": string,
  "partition": {
    object (Partition)
  }
}
Campos
parent

string

Obligatorio. Es la referencia a la tabla a la que se agregará la partición, con el formato projects/{project}/catalogs/{catalogs}/databases/{databases}/tables/{table}.
partition

object (Partition)

Obligatorio. Es la partición que se agregará.