Method: hive.v1.projects.catalogs.failover

Esegui il failover del catalogo in una nuova regione di replica primaria.

Richiesta HTTP


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

Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome del catalogo nel formato "projects/{projectId}/catalogs/{catalogId}"

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "primaryReplica": string,
  "validateOnly": boolean,
  "conditionalFailoverReplicationTime": string
}
Campi
primaryReplica

string

Obbligatorio. La regione che viene assegnata come nuova regione della replica principale. Ad esempio, "us-east1". Deve essere una delle regioni di replica nell'elenco delle repliche del catalogo contrassegnata come "secondaria".
validateOnly

boolean

Facoltativo. Se impostato, convalida solo la richiesta, ma non esegue l'aggiornamento. Può essere utilizzato per ispezionare replicationTime in qualsiasi momento, anche prima di eseguire un failover.
conditionalFailoverReplicationTime

string (Timestamp format)

Facoltativo. Se non è impostato, attendi che tutti i dati della regione di origine vengano replicati nella nuova regione principale prima di completare il failover, senza perdita di dati (chiamato anche "soft failover"). Se impostato, il failover viene eseguito immediatamente, accettando la perdita di tutti i dati di cui è stato eseguito il commit nella regione di origine dopo questo timestamp e che non sono ancora stati replicati. Se i dati di cui è stato eseguito il commit prima di questo orario non sono stati replicati, il failover non verrà eseguito e verrà restituito un errore (chiamato anche "failover rigido").

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Corpo della risposta

Messaggio di risposta per catalogs.failover.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "replicationTime": string
}
Campi
replicationTime

string (Timestamp format)

Solo output. Il timestamp minimo per cui tutti i metadati di spazi dei nomi e tabelle sono stati replicati nella regione specificata come nuova primaryReplica. Alcune risorse potrebbero essere state replicate più di recente rispetto a questo timestamp. Se è vuoto, la replica è stata appena creata e non è ancora stata inizializzata completamente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la Authentication Overview.