Vue FAILOVER_HISTORY

Aperçu

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

Pour tout commentaire ou assistance pour cette fonctionnalité, envoyez un e-mail à l'adresse [e-mail].

La vue INFORMATION_SCHEMA.FAILOVER_HISTORY contient une liste en quasi-temps réel des événements de basculement pour les réservations du projet d'administration qui utilisent la reprise après sinistre gérée. Chaque ligne représente un événement de basculement unique pour une seule réservation.

Remarque : Les noms de vues INFORMATION_SCHEMA.FAILOVER_HISTORY et INFORMATION_SCHEMA.FAILOVER_HISTORY_BY_PROJECT sont synonymes et peuvent être utilisés de manière interchangeable.

Rôles requis

Pour obtenir l'autorisation dont vous avez besoin pour interroger la vue INFORMATION_SCHEMA.FAILOVER_HISTORY, demandez à votre administrateur de vous attribuer 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 Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation bigquery.reservations.list, qui est nécessaire pour interroger la vue INFORMATION_SCHEMA.FAILOVER_HISTORY.

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Schéma

La vue INFORMATION_SCHEMA.FAILOVER_HISTORY présente le schéma suivant :

Nom de la colonne	Type de données	Valeur
project_id	STRING	ID du projet d'administration contenant la réservation.
project_number	INTEGER	Numéro du projet d'administration.
reservation_name	STRING	Nom de la réservation fourni par l'utilisateur. Par exemple, si l'URI de la réservation est projects/my-project/locations/US/reservations/my-reservation, le nom de la réservation est my-reservation.
start_time	TIMESTAMP	Heure à laquelle le basculement a été initié.
original_primary_location	STRING	Emplacement où la réservation a été créée à l'origine.
from_location	STRING	Emplacement principal avant le basculement. Cet emplacement devient secondaire après le basculement.
to_location	STRING	Emplacement secondaire avant le basculement, où le basculement a été initié. Cet emplacement devient l'emplacement principal après le basculement.
end_time	TIMESTAMP	Heure à laquelle le basculement progressif s'est terminé. NULL pendant le basculement progressif et toujours NULL pour le basculement forcé.
failover_mode	STRING	Type de basculement. Il peut s'agir de SOFT ou HARD. Pour en savoir plus, consultez Reprise après sinistre gérée.
state	STRING	État du basculement. Peut être STARTED (lorsqu'un basculement progressif est en cours ou pour un basculement forcé) ou COMPLETED (après la fin d'un basculement progressif). Pour en savoir plus sur l'état STARTED en cas de basculement forcé, consultez Limites.

Pour plus de stabilité, nous vous recommandons de lister explicitement les colonnes dans vos requêtes de schéma d'informations au lieu d'utiliser un caractère générique (SELECT *). Cela permet d'éviter que les requêtes ne soient interrompues si le schéma sous-jacent change.

Conservation des données

Cette vue conserve les événements de basculement pendant 180 jours, après quoi ils sont supprimés.

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
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.FAILOVER_HISTORY[_BY_PROJECT]	Niveau Projet	REGION

Remplacez l'élément suivant :

• PROJECT_ID (facultatif) : ID de votre projet Google Cloud . Si non spécifié, le projet par défaut est utilisé.
• REGION : tout nom de région d'ensemble de données. Par 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.

Limites

Les limites suivantes s'appliquent à la vue INFORMATION_SCHEMA.FAILOVER_HISTORY :

• Cette vue ne contient que les événements de basculement pour les réservations. Il ne contient pas d'événements de basculement pour les ensembles de données individuels.

• Chaque événement de basculement est enregistré dans la région qui devient la nouvelle région principale (to_location). Par exemple, si vous basculez une réservation de US vers EU, l'événement est enregistré dans region-eu. Pour afficher les événements de basculement dans les deux sens entre un emplacement principal et un emplacement secondaire, interrogez la vue séparément dans chaque région.

• Un basculement forcé n'attend pas la confirmation de l'opération dans l'emplacement secondaire. Par conséquent, un événement de basculement forcé n'a pas de signal de fin. La colonne state d'un événement de basculement forcé reste STARTED, et la colonne end_time reste NULL, même après l'entrée en vigueur du basculement.

Exemple

L'exemple suivant récupère les événements de basculement dans region-us (où US était l'emplacement de destination to_location du basculement) pour une réservation et un projet spécifiques, classés par événement le plus récent :

SELECT
  project_id,
  reservation_name,
  failover_mode,
  state,
  original_primary_location,
  from_location,
  to_location,
  start_time,
  end_time
FROM
  `reservation-admin-project.region-us`.INFORMATION_SCHEMA.FAILOVER_HISTORY
WHERE
  reservation_name = 'my-reservation'
ORDER BY
  start_time DESC;

Le résultat ressemble à ce qui suit :

+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+
|  project_id   | reservation_name | failover_mode |   state   | original_primary_location | from_location | to_location |     start_time      |      end_time       |
+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+
| my-admin-proj | my-reservation   | SOFT          | COMPLETED | US                        | EU            | US          | 2026-03-15 14:20:00 | 2026-03-15 14:31:05 |
| my-admin-proj | my-reservation   | HARD          | STARTED   | US                        | EU            | US          | 2026-02-10 08:15:30 | NULL                |
+---------------+------------------+---------------+-----------+---------------------------+---------------+-------------+---------------------+---------------------+