Visualizzazione SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

La vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION contiene informazioni sulle repliche dello schema associate a una prenotazione di failover. La visualizzazione INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION ha come ambito il progetto della prenotazione di failover, diversamente dalla visualizzazione INFORMATION_SCHEMA.SCHEMATA_REPLICAS che ha come ambito il progetto contenente il set di dati.

Ruolo richiesto

Per ottenere le autorizzazioni necessarie per eseguire query sulla visualizzazione INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION, 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 Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Schema

La vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS contiene informazioni sulle repliche dei set di dati. La vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS ha lo schema seguente:
Colonna Tipo Descrizione
failover_reservation_project_id STRING L'ID progetto del progetto di amministrazione della prenotazione di failover, se associato alla replica.
failover_reservation_name STRING Il nome della prenotazione di failover, se associata alla replica.
catalog_name STRING L'ID del progetto contenente il set di dati.
schema_name STRING L'ID del set di dati.
replica_name STRING Il nome della replica.
location STRING La regione o le regioni in cui è stata creata la replica.
replica_primary_assigned BOOL Se il valore è TRUE, la replica ha l'assegnazione principale.
replica_primary_assignment_complete BOOL Se il valore è TRUE, l'assegnazione principale è completata. Se il valore è FALSE, la replica non è (ancora) la replica principale, anche se replica_primary_assigned è uguale a TRUE.
creation_time TIMESTAMP La data/ora di creazione della replica. Quando viene creata per la prima volta, la replica non è completamente sincronizzata con la replica principale finché creation_complete non è uguale a TRUE. Il valore di creation_time viene impostato prima che creation_complete sia uguale TRUE.
creation_complete BOOL Se il valore è TRUE, la sincronizzazione completa iniziale della replica principale con la replica secondaria è completata.
replication_time TIMESTAMP

Il valore di replication_time indica l'obsolescenza del set di dati.

Alcune tabelle nella replica potrebbero essere precedenti a questo timestamp. Questo valore è visibile solo nella regione secondaria.

Se il set di dati contiene una tabella con dati in streaming, il valore di replication_time non sarà preciso.
sync_status JSON Lo stato della sincronizzazione tra la replica principale e quella secondaria. Restituisce NULL se la replica è una replica principale.

Ambito e sintassi

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

Nome vista Ambito risorsa Ambito regione
[RESERVATION_PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION[_BY_PROJECT] Livello progetto REGION
Sostituisci quanto segue:

  • (Facoltativo) RESERVATION_PROJECT_ID: l'ID del progetto di amministrazione della prenotazione. Se non specificato, viene utilizzato il progetto predefinito.

  • REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Esempi

Questa sezione elenca query di esempio della INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION visualizzazione.

Esempio: elenca tutti i set di dati replicati in una regione

L'esempio seguente elenca tutti i set di dati replicati nella regione US:

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

Il risultato è simile al seguente:

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