Visualizzazione FAILOVER_HISTORY

Per richiedere un feedback o assistenza per questa funzionalità, invia un'email all'indirizzo bigquery-wlm-feedback@google.com.

La visualizzazione INFORMATION_SCHEMA.FAILOVER_HISTORY contiene un elenco quasi in tempo reale di eventi di failover per le prenotazioni all'interno del progetto di amministrazione che utilizzano il disaster recovery gestito. Ogni riga rappresenta un singolo evento di failover per una singola prenotazione.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per eseguire query sulla visualizzazione INFORMATION_SCHEMA.FAILOVER_HISTORY, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore risorse BigQuery (roles/bigquery.resourceViewer) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione bigquery.reservations.list necessaria per interrogare la visualizzazione INFORMATION_SCHEMA.FAILOVER_HISTORY.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Schema

La visualizzazione INFORMATION_SCHEMA.FAILOVER_HISTORY ha lo schema seguente:

Nome colonna Tipo di dati Valore
project_id STRING ID del progetto di amministrazione che contiene la prenotazione.
project_number INTEGER Numero del progetto di amministrazione.
reservation_name STRING Il nome della prenotazione fornito dall'utente. Ad esempio, se l'URI della prenotazione è projects/my-project/locations/US/reservations/my-reservation, il nome della prenotazione è my-reservation.
start_time TIMESTAMP Ora in cui è stato avviato il failover.
original_primary_location STRING La località in cui è stata creata originariamente la prenotazione.
from_location STRING La posizione principale prima del failover. Questa località diventa secondaria dopo il failover.
to_location STRING La posizione secondaria prima del failover, in cui è stato avviato. Questa località diventa la principale dopo il failover.
end_time TIMESTAMP Ora in cui è stato completato il failover graduale. NULL mentre il failover soft è in corso e sempre NULL per il failover hard.
failover_mode STRING Tipo di failover. Può essere SOFT o HARD. Per maggiori informazioni, consulta Disaster recovery gestito.
state STRING Stato del failover. Può essere STARTED (durante l'avanzamento di un failover graduale o per un failover irreversibile) o COMPLETED (al termine di un failover graduale). Per saperne di più sullo stato STARTED per un failover forzato, consulta Limitazioni.

Per garantire la stabilità, ti consigliamo di elencare esplicitamente le colonne nelle query dello schema informativo anziché utilizzare un carattere jolly (SELECT *). L'elenco esplicito delle colonne impedisce l'interruzione delle query se lo schema sottostante cambia.

Conservazione dei dati

Questa visualizzazione conserva gli eventi di failover per 180 giorni, dopodiché vengono rimossi.

Ambito e sintassi

Le query su questa visualizzazione devono includere un qualificatore di regione. La tabella seguente spiega l'ambito della regione per questa visualizzazione:

Nome vista Ambito risorsa Ambito regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.FAILOVER_HISTORY[_BY_PROJECT] Livello progetto REGION
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo Google Cloud progetto. Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Limitazioni

Si applicano le seguenti limitazioni alla visualizzazione INFORMATION_SCHEMA.FAILOVER_HISTORY:

  • Questa visualizzazione contiene solo eventi di failover per le prenotazioni. Non contiene eventi di failover per singoli set di dati.

  • Ogni evento di failover viene registrato nella regione che diventa la nuova posizione principale (to_location). Ad esempio, se esegui il failover di una prenotazione da US a EU, l'evento viene registrato in region-eu. Per visualizzare gli eventi di failover in entrambe le direzioni tra una località primaria e una secondaria, esegui una query sulla visualizzazione separatamente in ogni regione.

  • Un failover forzato non attende la conferma dell'operazione nella posizione secondaria, pertanto un evento di failover forzato non ha un segnale di completamento. La colonna state per un evento di failover rigido rimane STARTED e la colonna end_time rimane NULL, anche dopo che il failover è diventato effettivo.

Esempio

L'esempio seguente recupera gli eventi di failover in region-us (dove US era la posizione di destinazione to_location del failover) per una prenotazione e un progetto specifici, ordinati in base all'evento più recente:

SELECT
  project_id,
  reservation_name,
  failover_mode,
  state,
  original_primary_location,
  from_location,
  to_location,
  start_time,
  end_time
FROM
  `reservation-admin-project.region-us`.INFORMATION_SCHEMA.FAILOVER_HISTORY
WHERE
  reservation_name = 'my-reservation'
ORDER BY
  start_time DESC;

L'output è simile al seguente:

+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+
|  project_id   | reservation_name | failover_mode |   state   | original_primary_location | from_location | to_location |     start_time      |      end_time       |
+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+
| my-admin-proj | my-reservation   | SOFT          | COMPLETED | US                        | EU            | US          | 2026-03-15 14:20:00 | 2026-03-15 14:31:05 |
| my-admin-proj | my-reservation   | HARD          | STARTED   | US                        | EU            | US          | 2026-02-10 08:15:30 | NULL                |
+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+