Method: iceberg.v1.restcatalog.v1.projects.catalogs.namespaces.register

Registra una tabla con la ubicación del archivo de metadatos proporcionada.

Solicitud HTTP


POST https://biglake.googleapis.com/iceberg/v1/restcatalog/v1/{parent=projects/*/catalogs/*/namespaces/*}/register

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Tabla para registrar en el formato: projects/{projectId}/catalogs/{catalogId}/namespaces/{namespace}.

Cuerpo de la solicitud

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

Representación JSON
{
  "name": string,
  "metadata-location": string,
  "overwrite": boolean
}
Campos
name

string

Obligatorio. Nombre de la tabla que se registrará.

metadata-location

string

Obligatorio. Ubicación de los metadatos de la tabla.

overwrite

boolean

Es opcional. Indica si se debe reemplazar la tabla si ya existe. El valor predeterminado es falso.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, la respuesta es una respuesta HTTP genérica, y el método define su formato.

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.