Visualizzazione SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

La visualizzazione 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 è limitata al progetto della prenotazione di failover, a differenza della visualizzazione INFORMATION_SCHEMA.SCHEMATA_REPLICAS, che è limitata al progetto che contiene 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 Gestisci 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_BY_FAILOVER_RESERVATION 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 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 immediato.
`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`. Per informazioni sul tempo necessario a una replica secondaria per diventare principale, vedi Promuovere la replica secondaria.
`creation_time`	`TIMESTAMP`	Data/ora di creazione della replica. Quando viene creata per la prima volta, la replica non è completamente sincronizzata con la replica primaria finché `creation_complete` non è uguale a `TRUE`. Il valore di `creation_time` è 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 è completata.
`replication_time`	`TIMESTAMP`	Il valore di `replication_time` indica l'obsolescenza del set di dati. Alcune tabelle nella replica potrebbero essere successive a 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à preciso.
`sync_status`	`JSON`	Lo stato della sincronizzazione tra le repliche primaria e secondaria per i set di dati di replica tra regioni e recupero di emergenza. 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 dalla replica primaria.
`replica_primary_assignment_completion_time`	`TIMESTAMP`	L'ora in cui è stato completato il passaggio dall'istanza principale alla replica.

Per garantire la stabilità, ti consigliamo di elencare esplicitamente le colonne nelle query dello schema delle informazioni anziché utilizzare un carattere jolly (SELECT *). L'elenco esplicito delle colonne impedisce l'interruzione delle query in caso di modifiche allo schema sottostante.

Ambito e sintassi

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

Nome vista	Ambito risorsa	Ambito della 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 Google Cloud progetto. Se non specificato, viene utilizzato il progetto predefinito.
REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Nota:devi utilizzare un qualificatore di regione per eseguire query sulle visualizzazioni INFORMATION_SCHEMA. La località di esecuzione della query deve corrispondere alla regione della vista INFORMATION_SCHEMA.

Esempi

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

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