Method: hive.v1.projects.catalogs.failover

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

HTTP-Anfrage

:


POST https://biglake.googleapis.com/hive/v1/{name=projects/*/catalogs/*}:failover

Für die URLs wird die Syntax der gRPC-Transcodierung verwendet.

Pfadparameter

Parameter
name

string

Erforderlich. Der Name des Katalogs im Format „projects/{projectId}/catalogs/{catalogId}“

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "primaryReplica": string,
  "validateOnly": boolean,
  "conditionalFailoverReplicationTime": string
}
Felder
primaryReplica

string

Erforderlich. Die Region, die als neue primäre Replikatregion zugewiesen wird. Beispiel: „us-east1“. Dies muss eine der Replikatregionen in der Replikatliste des Katalogs sein, die als „sekundär“ gekennzeichnet ist.
validateOnly

boolean

Optional. Wenn festgelegt, wird nur die Anfrage validiert, das Update wird aber nicht ausgeführt. Damit kann die replicationTime jederzeit geprüft werden, auch vor einem Failover.
conditionalFailoverReplicationTime

string (Timestamp format)

Optional. Wenn diese Option nicht festgelegt ist, wird vor dem Abschluss des Failovers gewartet, bis alle Daten aus der Quellregion in die neue primäre Region repliziert wurden. Dabei kommt es zu keinem Datenverlust (auch als „weicher Failover“ bezeichnet). Wenn diese Option festgelegt ist, erfolgt ein sofortiger Failover. Dabei wird der Verlust aller Daten in Kauf genommen, für die in der Quellregion nach diesem Zeitstempel ein Commit durchgeführt wurde und die noch nicht repliziert wurden. Wenn vor diesem Zeitpunkt übertragene Daten nicht repliziert wurden, wird das Failover nicht ausgeführt und es wird ein Fehler zurückgegeben (auch als „hartes Failover“ bezeichnet).

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".

Antworttext

Antwortnachricht für „catalogs.failover“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "replicationTime": string
}
Felder
replicationTime

string (Timestamp format)

Nur Ausgabe. Der minimale Zeitstempel, für den alle Namespaces und Tabellenmetadaten in der Region repliziert wurden, die als neue „primaryReplica“ angegeben ist. Einige Ressourcen wurden möglicherweise erst nach diesem Zeitstempel repliziert. Wenn das Feld leer ist, wurde das Replikat gerade erst erstellt und noch nicht vollständig initialisiert.

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".

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.