Vue SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION

Preview

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

La vue INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION contient des informations sur les instances répliquées de schéma associées à une réservation de basculement. La vue INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION est limitée au projet de la réservation de bascule, contrairement à la vue INFORMATION_SCHEMA.SCHEMATA_REPLICAS, qui est limitée au projet contenant l'ensemble de données.

Rôle requis

Pour obtenir les autorisations nécessaires pour interroger la vue INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de ressources BigQuery (roles/bigquery.resourceViewer) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Schéma

La vue INFORMATION_SCHEMA.SCHEMATA_REPLICAS contient des informations sur les instances répliquées des ensembles de données. La vue INFORMATION_SCHEMA.SCHEMATA_REPLICAS présente le schéma suivant :

Colonne	Type	Description
failover_reservation_project_id	STRING	ID du projet d'administration de la réservation de bascule, le cas échéant.
failover_reservation_name	STRING	Nom de la réservation de basculement si elle est associée au réplica.
catalog_name	STRING	ID du projet qui contient l'ensemble de données.
schema_name	STRING	ID de l'ensemble de données.
replica_name	STRING	Nom de l'instance répliquée.
location	STRING	Région ou emplacement multirégional dans lequel l'instance répliquée a été créée.
replica_primary_assigned	BOOL	Si la valeur est TRUE, l'instance répliquée possède l'attribution principale.
replica_primary_assignment_complete	BOOL	Si la valeur est TRUE, l'attribution principale est terminée. Si la valeur est FALSE, l'instance répliquée n'est pas (encore) l'instance répliquée principale, même si replica_primary_assigned est égal à TRUE.
creation_time	TIMESTAMP	Heure de création de l'instance répliquée. Lors de la création initiale de l'instance répliquée, celle-ci n'est pas entièrement synchronisée avec l'instance répliquée principale tant que creation_complete n'a pas la valeur TRUE. La valeur de creation_time est définie avant que creation_complete ne soit égal à TRUE.
creation_complete	BOOL	Si la valeur est TRUE, la synchronisation complète de l'instance répliquée principale avec l'instance répliquée secondaire est terminée.
replication_time	TIMESTAMP	La valeur replication_time indique l'obsolescence de l'ensemble de données. Certaines tables de l'instance répliquée peuvent être antérieures à cet horodatage. Cette valeur n'est visible que dans la région secondaire. Si l'ensemble de données contient une table contenant des données par flux, la valeur de replication_time ne sera pas précise.
sync_status	JSON	État de la synchronisation entre l'instance dupliquée principale et l'instance dupliquée secondaire. Renvoie NULL si l'instance dupliquée est une instance principale.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif de région. Le tableau suivant explique le champ d'application de la région pour cette vue :

Nom de la vue	Champ d'application de la ressource	Champ d'application de la région
[RESERVATION_PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION[_BY_PROJECT]	Niveau Projet	REGION

Remplacez les éléments suivants :

• Facultatif: RESERVATION_PROJECT_ID: ID du projet d'administration de la réservation. Si non spécifié, le projet par défaut est utilisé.

• REGION : tout nom de région d'ensemble de données. Exemple :`region-us`

Remarque : Vous devez utiliser un qualificatif de région pour interroger les vues INFORMATION_SCHEMA. L'emplacement d'exécution de la requête doit correspondre à la région de la vue INFORMATION_SCHEMA.

Exemples

Cette section recense des exemples de requêtes de la vue INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION.

Exemple : Recenser tous les ensembles de données répliqués d'une région

L'exemple suivant recense tous les ensembles de données répliqués dans la région US :

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

Le résultat ressemble à ce qui suit :

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