Ansicht SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

Die Ansicht INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION enthält Informationen zu Schemareplikaten, die mit einer Failover-Reservierung verknüpft sind. Der Bereich der INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION Ansicht ist auf das Projekt der Failover-Reservierung beschränkt. Im Gegensatz dazu ist der Bereich der INFORMATION_SCHEMA.SCHEMATA_REPLICAS Ansicht auf das Projekt beschränkt, das das Dataset enthält.

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.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die bigquery.reservations.listFailoverDatasets Berechtigung, die zum Abfragen der Ansicht INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION erforderlich ist.

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

Schema

Die Ansicht INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION hat das folgende Schema:
Spalte Typ Beschreibung
failover_reservation_project_id STRING Die Projekt-ID des Administratorprojekts der Failover-Reservierung, falls es mit dem Replikat verknüpft ist.
failover_reservation_name STRING Der Name der Failover-Reservierung, falls sie mit dem Replikat verknüpft ist.
catalog_name STRING Die Projekt-ID des Projekts, das das Dataset enthält.
schema_name STRING Die Dataset-ID des Datasets.
replica_name STRING Der Name des Replikats.
location STRING Die Region oder Multiregion, in der das Replikat erstellt wurde.
replica_primary_assigned BOOL Wenn der Wert TRUE ist, hat das Replikat die primäre Zuweisung. Wenn Sie ein sekundäres Replikat in ein primäres Replikat ändern, wird dieser Status sofort wirksam.
replica_primary_assignment_complete BOOL Wenn der Wert TRUE ist, ist die primäre Zuweisung abgeschlossen. Wenn der Wert FALSE ist, ist das Replikat (noch) nicht das primäre Replikat, auch wenn replica_primary_assigned gleich TRUE ist. Informationen dazu, wie lange es dauert, bis ein sekundäres Replikat zu einem primären Replikat wird, finden Sie unter Sekundäres Replikat hochstufen.
creation_time TIMESTAMP Die Erstellungszeit des Replikats Zeit. Wenn das Replikat zum ersten Mal erstellt wird, ist es erst vollständig mit dem primären Replikat synchronisiert, bis creation_complete gleich TRUE ist. Der Wert von creation_time wird festgelegt, bevor creation_complete gleich TRUE ist.
creation_complete BOOL Bei einem Wert von TRUE ist die erste vollständige Synchronisierung des primären Replikats mit dem sekundären Replikat abgeschlossen.
replication_time TIMESTAMP

Der Wert für replication_time gibt an, wie aktuell das Dataset ist.

Einige Tabellen im Replikat liegen möglicherweise vor diesem Zeitstempel. Dieser Wert ist nur in der sekundären Region sichtbar.

Wenn das Dataset eine Tabelle mit Streamingdaten enthält, ist der Wert von replication_time nicht genau.
sync_status JSON Der Status der Synchronisierung zwischen den primären und sekundären Replikaten für regionenübergreifende Replikations- und Notfallwiederherstellungs-Datasets. NULL wird zurückgegeben, wenn das Replikat ein primäres Replikat ist oder das Dataset keine Replikation verwendet.
replica_primary_assignment_time TIMESTAMP Die Zeit, zu der die primäre Umstellung auf das Replikat ausgelöst wurde.
replica_primary_assignment_completion_time TIMESTAMP Die Zeit, zu der die primäre Umstellung auf das Replikat abgeschlossen wurde.

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

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
[RESERVATION_PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION[_BY_PROJECT] Projektebene REGION
Dabei gilt:
  • Optional: PROJECT_ID: die ID Ihres Cloud de Confiance Projekts. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet.
  • REGION: ist ein beliebiger Dataset-Regionsname. Beispiel: `region-us`.

Beispiele

In diesem Abschnitt finden Sie Beispielabfragen der Ansicht INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION.

Beispiel: Alle replizierten Datasets in einer Region auflisten

Im folgenden Beispiel werden alle replizierten Datasets in der Region US aufgelistet:

SELECT *
FROM `region-us`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION
WHERE failover_reservation_name = "failover_reservation";

Das Ergebnis sieht etwa so aus:

+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+
| catalog_name | schema_name  | replica_name | location | replica_primary_assigned | replica_primary_assignment_complete |    creation_time    | creation_complete |  replication_time   | failover_reservation_project_id | failover_reservation_name |                                  sync_status                                  |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+
| project2     | test_dataset | us-east4     | us-east4 |                     true |                                true | 2024-05-09 20:34:06 |              true |                NULL | project1                        | failover_reservation      |                                                                          NULL |
| project2     | test_dataset | us           | US       |                    false |                               false | 2024-05-09 20:34:05 |              true | 2024-05-10 18:31:06 | project1                        | failover_reservation      | {"last_completion_time":"2024-06-06 18:31:06","error_time":null,"error":null} |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+