REST Resource: hive.v1.projects.catalogs

Ressource: HiveCatalog

Der HiveCatalog enthält Spark-/Hive-Datenbanken und -Tabellen im BigLake Metastore. Achten Sie beim Erstellen von Ressourcen in einem Katalog darauf, dass der Speicherbucket-Standort, der Spark-/Hive-Engine-Standort oder ein anderer Compute-Standort übereinstimmen. Der Katalog kann als Ziel für die Migration eines lokalen Hive-Metastore zu GCP betrachtet werden.

JSON-Darstellung 
{
  "name": string,
  "description": string,
  "locationUri": string,
  "replicas": [
    {
      object (Replica)
    }
  ],
  "createTime": string,
  "updateTime": string
}
Felder
name

string

ID. Der Ressourcenname. Format: projects/{project_id_or_number}/catalogs/{catalogId}
description

string

Optional. Speichert die Katalogbeschreibung. Die maximale Länge beträgt 4.000 Zeichen.
locationUri

string

Erforderlich. Der Cloud Storage-Pfad, in dem sich der Katalog befindet. Format: gs://bucket/path/to/catalog. Die maximale Länge beträgt 4.000 Zeichen.
replicas[]

object (Replica)

Nur Ausgabe. Die Replikate für die Katalogmetadaten.
createTime

string (Timestamp format)

Nur Ausgabe. Der Erstellungszeitpunkt des Katalogs.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt der Aktualisierung des Katalogs.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Replikat

Das Replikat des Katalogs.

JSON-Darstellung 
{
  "region": string,
  "state": enum (State)
}
Felder
region

string

Nur Ausgabe. Die Region des Replikats. Beispiel: us-east1
state

enum (State)

Nur Ausgabe. Der aktuelle Status des Replikats.

Bundesland

Wenn der Katalog in mehrere Regionen repliziert wird, beschreibt dieser Enum den aktuellen Status des Replikats.

Enums
STATE_UNSPECIFIED Der Status des Replikats ist unbekannt.
STATE_PRIMARY Gibt an, dass das Replikat die beschreibbare primäre Instanz ist.
STATE_PRIMARY_IN_PROGRESS Gibt an, dass das Replikat vor Kurzem als primäres Replikat zugewiesen wurde, aber noch nicht alle Datenbanken beschreibbar sind.
STATE_SECONDARY Gibt an, dass das Replikat ein schreibgeschütztes sekundäres Replikat ist.

Methoden

create

 Erstellt einen neuen Hive-Katalog.

delete

 Löscht einen vorhandenen Katalog, der durch die Katalog-ID angegeben wird.

failover

 Führen Sie ein Failover des Katalogs in eine neue primäre Replikatregion durch.

get

 Ruft den durch den Ressourcennamen angegebenen Katalog ab.

list

 Alle Kataloge in einem angegebenen Projekt auflisten.

patch

 Aktualisiert einen vorhandenen Katalog.