Ansicht FAILOVER_HISTORY

Wenn Sie Feedback oder Unterstützung für dieses Feature benötigen, senden Sie eine E‑Mail an bigquery-wlm-feedback@google.com.

Die Ansicht INFORMATION_SCHEMA.FAILOVER_HISTORY enthält eine nahezu in Echtzeit aktualisierte Liste von Failover-Ereignissen für Reservierungen im Administrationsprojekt, für die verwaltete Notfallwiederherstellung verwendet wird. Jede Zeile steht für ein einzelnes Failover-Ereignis für eine einzelne Reservierung.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle BigQuery-Ressourcenbetrachter (roles/bigquery.resourceViewer) für das Projekt zuzuweisen. Diese Rolle enthält die Berechtigung, die Sie zum Abfragen der Ansicht INFORMATION_SCHEMA.FAILOVER_HISTORY benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung bigquery.reservations.list, die zum Abfragen der INFORMATION_SCHEMA.FAILOVER_HISTORY-Ansicht erforderlich ist.

Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Schema

Die Ansicht INFORMATION_SCHEMA.FAILOVER_HISTORY hat das folgende Schema:

Spaltenname Datentyp Wert
project_id STRING ID des Administrationsprojekts, das die Reservierung enthält.
project_number INTEGER Nummer des Administrationsprojekts.
reservation_name STRING Der vom Nutzer angegebene Name der Reservierung. Wenn der Reservierungs-URI beispielsweise projects/my-project/locations/US/reservations/my-reservation ist, lautet der Reservierungsname my-reservation.
start_time TIMESTAMP Zeitpunkt, zu dem das Failover eingeleitet wurde.
original_primary_location STRING Der Ort, an dem die Reservierung ursprünglich erstellt wurde.
from_location STRING Der primäre Standort vor dem Failover. Dieser Standort wird nach dem Failover zum sekundären Standort.
to_location STRING Der sekundäre Standort vor dem Failover, an dem der Failover initiiert wurde. Dieser Standort wird nach dem Failover zum primären Standort.
end_time TIMESTAMP Zeitpunkt, zu dem das weiche Failover abgeschlossen wurde. NULL, während das Soft-Failover läuft, und immer NULL für das Hard-Failover.
failover_mode STRING Art des Failovers. Kann SOFT oder HARD sein. Weitere Informationen finden Sie unter Managed Disaster Recovery.
state STRING Status des Failovers. Kann STARTED (während eines weichen Failovers oder für ein hartes Failover) oder COMPLETED (nach Abschluss eines weichen Failovers) sein. Weitere Informationen zum Status STARTED bei einem Hard-Failover finden Sie unter Einschränkungen.

Aus Stabilitätsgründen empfehlen wir, Spalten in Ihren Informationsschema-Abfragen explizit aufzulisten, anstatt ein Platzhalterzeichen (SELECT *) zu verwenden. Wenn Sie Spalten explizit auflisten, wird verhindert, dass Abfragen fehlschlagen, wenn sich das zugrunde liegende Schema ändert.

Datenaufbewahrung

In dieser Ansicht werden Failover-Ereignisse 180 Tage lang aufbewahrt. Danach werden sie aus der Ansicht entfernt.

Bereich und Syntax

Für Abfragen dieser Ansicht muss ein Regions-Qualifier verwendet werden. In der folgenden Tabelle wird der Regionsbereich für diese Ansicht erläutert:

Ansichtsname Ressourcenbereich Regionsbereich
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.FAILOVER_HISTORY[_BY_PROJECT] Projektebene REGION
Dabei gilt:
  • Optional: PROJECT_ID: die ID Ihres Google Cloud -Projekts. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet.
  • REGION: ist ein beliebiger Dataset-Regionsname. Beispiel: `region-us`

Beschränkungen

Für die Ansicht INFORMATION_SCHEMA.FAILOVER_HISTORY gelten die folgenden Einschränkungen:

  • Diese Ansicht enthält nur Failover-Ereignisse für Reservierungen. Sie enthält keine Failover-Ereignisse für einzelne Datasets.

  • Jedes Failover-Ereignis wird in der Region aufgezeichnet, die zum neuen primären Standort wird (to_location). Wenn Sie beispielsweise ein Failover für eine Reservierung von US zu EU ausführen, wird das Ereignis in region-eu aufgezeichnet. Wenn Sie Failover-Ereignisse in beide Richtungen zwischen einem primären und einem sekundären Standort sehen möchten, fragen Sie die Ansicht separat in jeder Region ab.

  • Bei einem Hard-Failover wird nicht darauf gewartet, dass der Vorgang am sekundären Standort bestätigt wird. Ein Hard-Failover-Ereignis hat also kein Abschluss-Signal. Die Spalte state für ein Hard-Failover-Ereignis bleibt STARTED und die Spalte end_time bleibt NULL, auch nachdem das Failover wirksam geworden ist.

Beispiel

Im folgenden Beispiel werden die Failover-Ereignisse in region-us (wobei US der Zielort to_location des Failovers war) für eine bestimmte Reservierung und ein bestimmtes Projekt abgerufen, sortiert nach dem letzten Ereignis:

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;

Die Ausgabe sieht etwa so aus:

+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+
|  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                |
+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+