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

Cette page explique comment ajouter des indicateurs de base de données pour une instance, les modifier et les supprimer d'une instance dans un cluster AlloyDB pour PostgreSQL.

Les indicateurs de base de données sont utilisés pour de nombreuses opérations, y compris l'ajustement des paramètres et des options PostgreSQL, ainsi que la configuration et le réglage d'une instance. Les modifications apportées à la valeur d'un indicateur de base de données persistent pour son instance jusqu'à ce que vous le supprimiez 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é souhaitée.

Une fois que vous avez défini, supprimé ou modifié un indicateur pour une instance de base de données, AlloyDB peut redémarrer l'instance. Cela dépend de l'indicateur, comme indiqué dans la section Indicateurs de base de données compatibles.

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

  • Temps d'arrêt faible. Cette règle est activée par défaut. Nous vous recommandons d'utiliser cette stratégie pour tous vos clusters AlloyDB de production, car elle réduit au maximum les temps d'arrêt de l'application.

    Lorsque la stratégie de temps d'arrêt faible est activée, la mise à jour d'un indicateur nécessitant un redémarrage sur l'instance principale de votre cluster a les effets suivants:

    • L'instance principale ne connaît qu'un temps d'arrêt inférieur à une seconde pour la plupart des charges de travail.

    • La nouvelle valeur du flag de l'instance principale est appliquée au bout d'environ 15 minutes.

    La mise à jour d'un indicateur 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.

    • L'indicateur de l'instance de pool de lecture est mis à jour avec sa nouvelle valeur au bout d'environ 10 minutes.

  • Forcer l'application. Pour appliquer les mises à jour des indicateurs 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, car elle vous permet d'ajouter ou de modifier rapidement des indicateurs en échange d'un temps d'arrêt d'instance plus long et d'une diminution temporaire des performances ou du débit de la base de données. Votre cluster retrouve ses performances optimales quelques minutes après l'application forcée d'une mise à jour de l'indicateur.

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

    • L'instance principale subit une interruption d'environ une minute.

    • La nouvelle valeur de l'indicateur de l'instance principale est appliquée au bout d'une à deux minutes.

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

    • L'instance de pool de lecture subit une interruption d'environ une minute.

    • L'indicateur de l'instance de pool de lecture est mis à jour avec sa nouvelle valeur au bout d'une à deux minutes.

Avant de commencer

  • Le projet Google Cloud que vous utilisez doit avoir été autorisé à accéder à AlloyDB.
  • Vous devez disposer de l'un des rôles IAM suivants dans le projet Google Cloud que vous utilisez :
    • roles/alloydb.admin (rôle IAM prédéfini "AlloyDB Admin")
    • 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.

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 de votre cluster, sélectionnez une instance, puis cliquez sur Modifier.

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

    Ajouter un indicateur

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

    Modifier un indicateur

    1. Pour modifier une option de base de données présente dans votre instance, développez l'option de base de données et modifiez sa valeur dans la section Modifier l'option 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-le, puis cliquez sur l'icône de suppression.
    2. Cliquez sur OK.

  5. Cliquez sur Mettre à jour l'instance.

gcloud

Utilisez la commande gcloud alloydb instances update pour modifier les options 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 indicateurs plus rapidement, incluez l'argument --update-mode=FORCE_APPLY. Étant donné que cela peut temporairement réduire 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'un ou de plusieurs spécifications de drapeaux de base de données, séparés par une virgule. Chaque spécification se compose du nom de l'indicateur, d'un signe égal (=) et de la valeur à attribuer aux indicateurs. Pour les indicateurs de base de données qui ne prennent pas de valeurs, indiquez le nom de l'indicateur suivi d'un signe égal (=).
  • REGION_ID: région où se trouve l'instance (par exemple, us-central1).
  • CLUSTER_ID: ID du cluster dans lequel se trouve l'instance.
  • PROJECT_ID: ID du projet dans lequel le cluster est placé. en cours de cycle de maintenance avec un temps d'arrêt faible ou nul, après avoir modifié les indicateurs de base de données.

Pour afficher la liste des indicateurs actuels d'une instance définis manuellement, exécutez la commande suivante:

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