Vista 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 INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION vista è limitata a il progetto della prenotazione di failover, a differenza della INFORMATION_SCHEMA.SCHEMATA_REPLICAS vista che è limitata al progetto che contiene il set di dati.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per eseguire query sulla vista 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.

Questo ruolo predefinito contiene l'autorizzazione bigquery.reservations.listFailoverDatasets , necessaria per eseguire query sulla vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION.

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

Schema

La vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION ha il seguente schema:
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 progetto del progetto che contiene 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 primaria. Quando modifichi una replica secondaria in una primaria, questo stato ha effetto immediatamente.
replica_primary_assignment_complete BOOL Se il valore è TRUE, l'assegnazione primaria è completa. Se il valore è FALSE, la replica non è (ancora) la replica primaria, anche se replica_primary_assigned è uguale a TRUE. Per informazioni sul tempo necessario affinché una replica secondaria diventi primaria, consulta Promuovere la replica secondaria.
creation_time TIMESTAMP L'ora di creazione della replica tempo. Quando la replica viene creata per la prima volta, non è completamente sincronizzata con la replica primaria finché creation_complete non è uguale a TRUE. Il valore di creation_time viene impostato prima che creation_complete sia uguale a TRUE.
creation_complete BOOL Se il valore è TRUE, la sincronizzazione completa iniziale della replica primaria con la replica secondaria è stata completata.
replication_time TIMESTAMP

Il valore di replication_time indica la non aggiornatezza del set di dati.

Alcune tabelle nella replica potrebbero essere più recenti di questo timestamp. Questo valore è visibile solo nella regione secondaria.

Se il set di dati contiene una tabella con dati di streaming, il valore di replication_time non sarà accurato.
sync_status JSON Lo stato della sincronizzazione tra le repliche primaria e secondaria per i set di dati di replica tra regioni e di disaster recovery. Restituisce NULL se la replica è una replica primaria o se il set di dati non utilizza la replica.
replica_primary_assignment_time TIMESTAMP L'ora in cui è stato attivato il passaggio alla replica primaria.
replica_primary_assignment_completion_time TIMESTAMP L'ora in cui è stato completato il passaggio alla replica primaria.

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.

Ambito e sintassi

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

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) PROJECT_ID: l'ID del tuo Cloud de Confiance progetto. Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: il nome di una regione del set di dati. Ad esempio, `region-us`.

Esempi

In questa sezione sono elencate query di esempio della vista INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION.

Esempio: elencare 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} |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+