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

Agrega particiones a una tabla.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Referencia a la tabla a la que se agregarán las particiones, en 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. 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 mostrará ALREADY_EXISTS si ya existe alguna partición. Si la marca se establece como verdadera, 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 de 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. Referencia a la tabla a la que se agregará la partición, en el formato projects/{project}/catalogs/{catalogs}/databases/{databases}/tables/{table}.
partition

object (Partition)

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