REST Resource: hive.v1.projects.catalogs

Recurso: HiveCatalog

HiveCatalog contiene bases de datos y tablas de Spark/Hive en BigLake Metastore. Cuando crees recursos en un catálogo, lo ideal es que te asegures de que coincidan la ubicación del bucket de almacenamiento, la ubicación del motor de Spark o Hive, o cualquier otra ubicación de procesamiento. El catálogo se puede ver como el destino para migrar un metastore de Hive local a GCP.

Representación JSON 
{
  "name": string,
  "description": string,
  "locationUri": string,
  "replicas": [
    {
      object (Replica)
    }
  ],
  "createTime": string,
  "updateTime": string
}
Campos
name

string

Es el identificador. Nombre del recurso. Formato: projects/{project_id_or_number}/catalogs/{catalogId}
description

string

Es opcional. Almacena la descripción del catálogo. La longitud máxima es de 4,000 caracteres.
locationUri

string

Obligatorio. Es la ruta de acceso a la ubicación de Cloud Storage en la que existe el catálogo. Formato: gs://bucket/path/to/catalog La longitud máxima es de 4,000 caracteres.
replicas[]

object (Replica)

Solo salida. Son las réplicas de los metadatos del catálogo.
createTime

string (Timestamp format)

Solo salida. La hora de creación del catálogo.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Es la hora de actualización del catálogo.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Réplica

Es la réplica del catálogo.

Representación JSON 
{
  "region": string,
  "state": enum (State)
}
Campos
region

string

Solo salida. Es la región de la réplica. Por ejemplo: us-east1.
state

enum (State)

Solo salida. Es el estado actual de la réplica.

Estado

Si el catálogo se replica en varias regiones, este enum describe el estado actual de la réplica.

Enums
STATE_UNSPECIFIED Se desconoce el estado de la réplica.
STATE_PRIMARY Indica que la réplica es la principal que admite escritura.
STATE_PRIMARY_IN_PROGRESS Indica que la réplica se asignó recientemente como principal, pero aún no se pueden escribir todas las bases de datos.
STATE_SECONDARY Indica que la réplica es una réplica secundaria de solo lectura.

Métodos

create

 Crea un catálogo de Hive nuevo.

delete

 Borra un catálogo existente especificado por el ID del catálogo.

failover

 Conmuta por error el catálogo a una nueva región de réplica principal.

get

 Obtiene el catálogo que especifica el nombre del recurso.

list

 Enumera todos los catálogos en un proyecto especificado.

patch

 Actualiza un catálogo existente.