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 la ubicación del bucket de almacenamiento, la ubicación del motor de Spark o Hive, o cualquier otra ubicación de procesamiento coincidan. Catalog se puede ver como el destino para migrar un almacén de metadatos de Hive local a Google Cloud.

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 de la ubicación de Cloud Storage en la que se encuentra 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. 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 puede escribir en 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 en un proyecto especificado.

delete

Borra un catálogo de Hive especificado.

failover

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

get

Obtiene detalles de un catálogo de Hive especificado.

list

Enumera todos los catálogos de Hive en un proyecto especificado.

patch

Actualiza un catálogo de Hive existente en un proyecto especificado.