REST Resource: hive.v1.projects.catalogs

Ressource: HiveCatalog

Der HiveCatalog enthält Spark-/Hive-Datenbanken und -Tabellen im BigLake Metastore. Wenn Sie Ressourcen in einem Katalog erstellen, sollten Sie darauf achten, dass der Speicherort des Storage-Buckets, der Spark-/Hive-Engine oder eines anderen Compute-Standorts übereinstimmt. Der Katalog kann als Ziel für die Migration eines lokalen Hive-Metastores zu Google Cloud 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-Speicherortpfad, 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äre Instanz zugewiesen wurde, aber noch nicht alle Datenbanken beschreibbar sind.
STATE_SECONDARY Gibt an, dass das Replikat ein sekundäres Replikat mit Lesezugriff ist.

Methoden

create

Erstellt einen neuen Hive-Katalog in einem angegebenen Projekt.

delete

Löscht einen angegebenen Hive-Katalog.

failover

Führt ein Failover eines angegebenen Hive-Katalogs auf eine neue primäre Replikatregion aus.

get

Ruft Details zu einem angegebenen Hive-Katalog ab.

list

Listet alle Hive-Kataloge in einem angegebenen Projekt auf.

patch

Aktualisiert einen vorhandenen Hive-Katalog in einem angegebenen Projekt.