Ansicht SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

Die Ansicht INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION enthält Informationen zu Schemarepliken, die mit einer Failover-Reservierung verknüpft sind. Die Ansicht INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION ist auf das Projekt der Failover-Reservierung beschränkt, im Gegensatz zur Ansicht INFORMATION_SCHEMA.SCHEMATA_REPLICAS, die auf das Projekt beschränkt ist, das das Dataset enthält.

Erforderliche Rolle

Um die Berechtigungen zu erhalten, die Sie zum Abfragen der Ansicht INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION benötigen, müssen Sie Ihren Administrator bitten, Ihnen die IAM-Rolle BigQuery-Ressourcenbetrachter (roles/bigquery.resourceViewer) für das Projekt zu gewähren. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Schema

Die Ansicht INFORMATION_SCHEMA.SCHEMATA_REPLICAS enthält Informationen zu Dataset-Repliken. Die Ansicht INFORMATION_SCHEMA.SCHEMATA_REPLICAS hat das folgende Schema:
Spalte Typ Beschreibung
failover_reservation_project_id STRING Die Projekt-ID des Failover-Reservierungs-Administratorprojekts, falls es mit dem Replikativerknüpft ist.
failover_reservation_name STRING Der Name der Failover-Reservierung, falls sie mit dem Replikat verknüpft ist.
catalog_name STRING Die 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.
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.
creation_time TIMESTAMP Der Erstellungszeitpunkt des Replicas. Wenn das Replikat zum ersten Mal erstellt wird, wird es erst dann vollständig mit dem primären Replikat synchronisiert, wenn 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 alt die Daten im Datensatz sind.

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

Wenn der Datensatz eine Tabelle mit Streamingdaten enthält, ist der Wert von replication_time nicht korrekt.
sync_status JSON Der Status der Synchronisierung zwischen dem primären und dem sekundären Replikat. Gibt NULL zurück, wenn es sich um ein primäres Replikat handelt.

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] auf Projektebene REGION
Ersetzen Sie Folgendes:

  • Optional: RESERVATION_PROJECT_ID: die ID des Administrationsprojekts der Reservierung. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet.

  • REGION: ist ein beliebiger Dataset-Regionsname. Beispiel: `region-us`

Beispiele

In diesem Abschnitt sind Beispielabfragen für die INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION-Ansicht aufgeführt.

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