REST Resource: hive.v1.projects.catalogs

Recurso: HiveCatalog

O HiveCatalog contém bancos de dados e tabelas do Spark/Hive no BigLake Metastore. Ao criar recursos em um catálogo, verifique se o local do bucket de armazenamento, do mecanismo Spark / Hive ou de qualquer outro local de computação corresponde. O catálogo pode ser visto como o destino da migração de um metastore do Hive no local para o GCP.

Representação JSON
{
  "name": string,
  "description": string,
  "locationUri": string,
  "replicas": [
    {
      object (Replica)
    }
  ],
  "createTime": string,
  "updateTime": string
}
Campos
name

string

Identificador. O nome do recurso. Formato: projects/{project_id_or_number}/catalogs/{catalogId}

description

string

Opcional. Armazena a descrição do catálogo. O tamanho máximo é de 4.000 caracteres.

locationUri

string

Obrigatório. O caminho do local do Cloud Storage em que o catálogo está. Formato: gs://bucket/path/to/catalog. O tamanho máximo é de 4.000 caracteres.

replicas[]

object (Replica)

Apenas saída. As réplicas dos metadados do catálogo.

createTime

string (Timestamp format)

Apenas saída. A hora de criação do catálogo.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Apenas saída. A hora da atualização do catálogo.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Réplica

A réplica do catálogo.

Representação JSON
{
  "region": string,
  "state": enum (State)
}
Campos
region

string

Apenas saída. A região da réplica. Por exemplo, us-east1.

state

enum (State)

Apenas saída. O estado atual da réplica.

Estado

Se o catálogo for replicado para várias regiões, esse enum descreverá o estado atual da réplica.

Tipos enumerados
STATE_UNSPECIFIED O estado da réplica é desconhecido.
STATE_PRIMARY Indica que a réplica é a principal gravável.
STATE_PRIMARY_IN_PROGRESS Indica que a réplica foi atribuída recentemente como primária, mas nem todos os bancos de dados ainda são graváveis.
STATE_SECONDARY Indica que a réplica é uma réplica secundária somente leitura.

Métodos

create

Cria um catálogo do Hive.

delete

Exclui um catálogo existente especificado pelo respectivo ID.

failover

Faça failover do catálogo para uma nova região de réplica principal.

get

Encontra o catálogo especificado pelo nome do recurso.

list

Lista todos os catálogos em um projeto especificado.

patch

Atualiza um catálogo existente.