Modifier le quorum birégional

Cette page explique comment vérifier l'état de fonctionnement du quorum birégional Spanner et comment modifier manuellement le quorum en cas d'interruption du service.

Pour en savoir plus sur les emplacements birégionaux, consultez la page Configurations d'instances birégionales de Spanner.

Vérifier l'état du quorum birégional

Vous pouvez vérifier l'état du quorum birégional comme suit.

  • Sur la page Présentation de la base de données
  • Utiliser le tableau de bord des insights système

Sur la page de présentation de la base de données

  1. Accédez à la page Instances de Spanner dans la console Google Cloud.

    Accéder à la page Instances

  2. Cliquez sur le nom de l'instance qui se trouve dans une configuration birégionale.

  3. Cliquez sur le nom de la base de données.

  4. Sous "Présentation", recherchez la ligne Quorum, qui indique l'état du quorum birégional de votre instance:

    • Si le quorum est atteint dans les deux régions, l'état indique Birégional.

    • Si un basculement manuel ou géré par Google a été effectué, le nom de la région de diffusion (par exemple, asia-south1) s'affiche.

Tableau de bord des insights système

Après avoir créé une configuration birégionale, vous pouvez afficher la métrique Disponibilité du quorum birégional dans le tableau de bord des insights système au niveau de l'instance.

Pour en savoir plus, consultez Afficher le tableau de bord des insights système.

Faire passer le quorum birégional de deux régions à une région unique (basculement)

Pour basculer manuellement en cas d'indisponibilité régionale ou d'un problème de partitionnement du réseau:

Console Google Cloud

  1. Accédez à la page Instances de Spanner dans la console Google Cloud.

    Accéder à la page Instances

  2. Cliquez sur le nom de l'instance qui se trouve dans une configuration birégionale.

  3. Cliquez sur Insights sur le système dans le menu de navigation.

  4. Recherchez la métrique Disponibilité du quorum birégional.

  5. Si la métrique de disponibilité du quorum birégional indique des perturbations dans une région, cliquez sur Icône du bouton "Activer Cloud Shell" Activer Cloud Shell en haut de la console Google Cloud.

    Cloud Shell s'ouvre.

  6. Pour faire passer le quorum birégional de deux régions à une région unique, saisissez la commande suivante dans l'onglet de la gcloud CLI : gcloud spanner databases change-quorum. Pour obtenir des instructions détaillées, consultez l'onglet gcloud.

gcloud CLI

Exécutez la commande gcloud spanner databases change-quorum pour remplacer le quorum birégional par une région unique.

gcloud spanner databases change-quorum
    DATABASE_ID --instance=INSTANCE_ID
    --single-region --serving-location=SERVING_LOCATION
    [--etag=ETAG]

Remplacez les éléments suivants :

  • DATABASE_ID: identifiant permanent de la base de données.

  • INSTANCE_ID : identifiant permanent de l'instance.

  • SERVING_LOCATION: configuration de l'instance régionale vers laquelle vous souhaitez basculer. Par exemple, si asia-south1 (Mumbai) n'est pas opérationnel et que vous souhaitez basculer vers asia-south2 (Delhi), saisissez asia-south2. Assurez-vous que SERVING_LOCATION est la région opérationnelle. Si vous sélectionnez une région incorrecte pour le basculement, la base de données devient indisponible, qui est irrécupérable avant la remise en ligne de la région.

Indicateurs facultatifs :

  • --etag=ETAG: l'argument ETAG peut être utilisé pour la protection contre la rejeu.

Pour vérifier l'état de l'opération de modification du quorum, exécutez la commande gcloud spanner databases describe. Le champ quorumInfo fournit des informations sur l'opération.

gcloud spanner databases describe DATABASE_ID
    --instance=INSTANCE_ID

Faire passer le quorum birégional de région unique à birégional (restauration)

Pour effectuer une restauration manuelle une fois que la région interrompue est opérationnelle ou après la résolution du problème de partition réseau:

Console Google Cloud

  1. Accédez à la page Instances de Spanner dans la console Google Cloud.

    Accéder à la page Instances

  2. Cliquez sur le nom de l'instance qui se trouve dans une configuration birégionale.

  3. Cliquez sur Insights sur le système dans le menu de navigation.

  4. Recherchez la métrique Disponibilité du quorum birégional.

  5. Sur la métrique de disponibilité du quorum pour les emplacements birégionaux, cliquez sur Modifier le quorum de la région.

    Cloud Shell s'ouvre.

  6. Pour faire passer le quorum birégional de deux régions à une région unique, saisissez la commande suivante dans l'onglet de la gcloud CLI : gcloud spanner databases change-quorum. Pour obtenir des instructions détaillées, consultez l'onglet gcloud.

gcloud CLI

Exécutez la commande gcloud spanner databases change-quorum pour modifier le quorum birégional en passant d'une région unique à une zone birégionale.

gcloud spanner databases change-quorum
    DATABASE_ID --instance=INSTANCE_ID
    --dual-region
    [--etag=ETAG]

Remplacez les éléments suivants :

  • DATABASE_ID: identifiant permanent de la base de données.

  • INSTANCE_ID : identifiant permanent de l'instance.

Indicateurs facultatifs :

  • --etag=ETAG: l'argument ETAG peut être utilisé pour un contrôle de simultanéité optimiste.

Pour vérifier l'état de l'opération de modification du quorum, exécutez la commande gcloud spanner databases describe. Le champ quorumInfo fournit des informations sur l'opération.

gcloud spanner databases describe DATABASE_ID
    --instance=INSTANCE_ID

Étapes suivantes