Configurer les options de base de données d'une instance

Pour régler les paramètres PostgreSQL, ajuster les options de base de données et personnaliser le comportement des instances dans un cluster AlloyDB pour PostgreSQL, vous pouvez ajouter, modifier ou supprimer des options de base de données sur une instance. Les modifications apportées à la valeur d'un indicateur de base de données persistent pour son instance jusqu'à ce que vous supprimiez l'indicateur ou que vous modifiiez à nouveau sa valeur.

Parfois, définir un indicateur implique d'en définir un autre, afin d'activer complètement la fonctionnalité cible.

Après avoir défini, supprimé ou modifié un flag pour une instance de base de données, AlloyDB peut redémarrer l'instance. Cela dépend de l'option, comme indiqué dans la section Options de base de données compatibles.

Lorsque vous modifiez un indicateur de base de données dans l'instance principale ou une instance de pool de lecture qui nécessite un redémarrage, vous pouvez choisir l'une des règles de maintenance suivantes :

  • Temps d'arrêt réduit. Cette règle est activée par défaut. Nous vous recommandons d'utiliser cette règle pour tous vos clusters AlloyDB de production, car elle minimise les temps d'arrêt des applications.

    Lorsque la règle de temps d'arrêt faible est activée, la mise à jour d'un flag qui nécessite un redémarrage sur l'instance principale de votre cluster a les effets suivants :

    • L'instance principale subit moins d'une seconde d'indisponibilité pour la plupart des charges de travail.

    • La mise à jour de l'option sur l'instance principale vers sa nouvelle valeur se termine après environ 15 minutes.

    La mise à jour d'un flag qui nécessite un redémarrage sur une instance de pool de lecture a les effets suivants :

    • L'instance de pool de lecture ne nécessite aucun temps d'arrêt.

    • La mise à jour de l'option sur l'instance de pool de lecture vers sa nouvelle valeur prend environ 10 minutes.

  • Appliquer de force. Pour appliquer les mises à jour des options plus rapidement, utilisez l'option FORCE_APPLY avec la commande gcloud beta alloydb instances update.

    Cette stratégie est plus adaptée aux environnements de développement. Elle vous permet d'ajouter ou de modifier rapidement des flags. Cependant, les instances sont alors indisponibles plus longtemps, et les performances ou le débit de la base de données seront temporairement réduits. Votre cluster retrouve ses performances optimales quelques minutes après l'application forcée d'une mise à jour de flag.

    Lorsque la règle d'application forcée est activée, la mise à jour d'un flag qui nécessite un redémarrage sur l'instance principale de votre cluster a les effets suivants :

    • L'instance principale subit environ une minute de temps d'arrêt.

    • La mise à jour de l'option sur l'instance principale se termine après une ou deux minutes.

    La mise à jour d'un flag qui nécessite un redémarrage sur une instance de pool de lecture a les effets suivants :

    • L'instance de pool de lecture subit environ une minute de temps d'arrêt.

    • La mise à jour de l'option sur l'instance de pool de lecture se termine après une ou deux minutes.

Avant de commencer

  • Le projet Google Cloud que vous utilisez doit avoir été activé pour accéder à AlloyDB.
  • Vous devez disposer de l'un de ces rôles IAM dans le projet Google Cloud que vous utilisez :
    • roles/alloydb.admin (rôle IAM prédéfini d'administrateur AlloyDB)
    • roles/owner (rôle IAM de base "Propriétaire")
    • roles/editor (rôle IAM de base Éditeur)

    Si vous ne disposez d'aucun de ces rôles, contactez l'administrateur de votre organisation pour demander l'accès.

Pour vous assurer que la maintenance et les mises à jour peuvent créer des emplacements de réplication temporaires pour la synchronisation d'état, assurez-vous que le nombre total d'emplacements de réplication est inférieur d'au moins un à la limite max_wal_senders. Pour en savoir plus sur la configuration de cette option, consultez Configurer vos instances sources.

Console

  1. Dans la console Google Cloud , accédez à la page Clusters.

    accéder aux clusters

  2. Cliquez sur un cluster dans la colonne Nom de la ressource.

  3. Sur la page Vue d'ensemble, accédez à Instances dans votre cluster, sélectionnez une instance, puis cliquez sur Modifier.

  4. Développez Options de configuration avancées.

  5. Ajoutez, modifiez ou supprimez un indicateur de base de données de votre instance :

    Ajouter un indicateur

    1. Pour ajouter un indicateur de base de données à votre instance, cliquez sur Ajouter un indicateur.
    2. Sélectionnez un indicateur dans la liste Nouvel indicateur de base de données.
    3. Indiquez une valeur pour l'option.
    4. Cliquez sur OK.

    Modifier un flag

    1. Pour modifier un indicateur de base de données présent dans votre instance, développez l'indicateur de base de données et modifiez la valeur de l'indicateur existant dans la section Modifier l'indicateur de base de données.
    2. Cliquez sur OK.

    Supprimer un indicateur

    1. Pour supprimer un indicateur de base de données de votre instance, sélectionnez un indicateur, puis cliquez sur l'icône de suppression.
    2. Cliquez sur OK.

  6. Cliquez sur Mettre à jour l'instance.

gcloud

Utilisez la commande gcloud alloydb instances update pour modifier les indicateurs de base de données d'une instance.

   gcloud alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID

Pour appliquer les mises à jour des options plus rapidement, incluez l'argument --update-mode=FORCE_APPLY. Comme cela peut réduire temporairement les performances de la base de données, évitez d'utiliser cette option dans un environnement de production.

   gcloud beta alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID \
   --update-mode=FORCE_APPLY

Remplacez les éléments suivants :

  • INSTANCE_ID : ID de l'instance
  • FLAGS_LIST : liste d'une ou de plusieurs spécifications d'indicateurs de base de données, séparées par une virgule. Chaque spécification se compose du nom de l'option, d'un signe égal (=) et de la valeur à attribuer aux options. Pour les indicateurs de base de données qui n'acceptent pas de valeurs, indiquez le nom de l'indicateur suivi d'un signe égal (=).
  • REGION_ID : région où l'instance est placée, par exemple us-central1.
  • CLUSTER_ID : ID du cluster où l'instance est placée.
  • PROJECT_ID : ID du projet dans lequel le cluster est placé.

Pour afficher la liste des options actuelles d'une instance définies manuellement, exécutez la commande suivante :

   gcloud alloydb instances describe INSTANCE_ID \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID