Configurer les paramètres de la base de données AlloyDB Omni

Sélectionnez une version de la documentation :

Pour configurer un paramètre de base de données pour AlloyDB Omni, vous pouvez mettre à jour les paramètres GUC (Grand Unified Configuration) de l'une des manières suivantes :

  • Fichier postgresql.conf pour les environnements exécutant AlloyDB Omni sur une VM.

  • Manifeste du cluster de base de données pour les environnements exécutant AlloyDB Omni sur un cluster Kubernetes.

Mettre à jour un paramètre dans AlloyDB Omni conteneurisé

Dans une instance AlloyDB Omni exécutée sur une VM, vous pouvez mettre à jour un paramètre en modifiant le fichier postgresql.conf comme suit :

  1. Localisez le fichier de configuration postgresql.conf pour votre installation d'AlloyDB Omni.

  2. Utilisez un éditeur de texte pour ajouter ou modifier un indicateur de base de données dans postgresql.conf.

    Par exemple, pour appliquer l'expiration du mot de passe, définissez l'indicateur suivant dans le fichier postgresql.conf :

    password.enforce_expiration = ON
    
  3. Une fois les indicateurs de base de données ajoutés ou modifiés, rechargez le fichier postgresql.conf pour que les modifications soient prises en compte. Par exemple, si vous avez installé AlloyDB Omni à l'aide de Docker, exécutez la commande suivante pour redémarrer votre instance Docker et recharger postgresql.conf :

    docker restart CONTAINER-NAME

Pour en savoir plus, consultez Définir des paramètres dans la documentation PostgreSQL.

Mettre à jour un paramètre dans AlloyDB Omni sur un cluster Kubernetes

Vous pouvez configurer les paramètres de la base de données à l'aide du champ parameters dans la section primarySpec du fichier manifeste de votre cluster de bases de données :

spec:
  primarySpec:
    parameters:
      "PARAMETER_NAME": "PARAMETER_VALUE"
      ...

Remplacez les éléments suivants :

  • PARAMETER_NAME : nom du paramètre, par exemple autovacuum.
  • PARAMETER_VALUE : valeur du paramètre (par exemple, off).

Pour que les modifications apportées à certains paramètres prennent effet, vous devez redémarrer votre cluster. Vous pouvez obtenir la liste des paramètres qui nécessitent un redémarrage à partir de pg_catalog.pg_settings. Tout paramètre comportant pg_catalog.pg_settings.context = 'postmaster' nécessite un redémarrage.

Pour mettre à jour les paramètres de la base de données, exécutez la commande suivante :

kubectl patch dbclusters.alloydbomni.dbadmin.goog dbcluster-sample -p '{"spec":{"primarySpec":{"parameters": {"PARAMETER_NAME": "PARAMETER_VALUE"}}}}' --type=merge

Les paramètres se trouvent dans la partie status du champ currentParameters.

Pour afficher les paramètres de la base de données, exécutez la commande suivante :

kubectl get dbclusters.alloydbomni.dbadmin.goog dbcluster-sample -o jsonpath={.status.primary.currentParameters}

La sortie ressemble à ceci :

{"autovacuum":"off","max_connections":"3000"}

Si AlloyDB Omni ne peut pas appliquer les paramètres que vous demandez dans le fichier manifeste du cluster de bases de données, les valeurs du champ currentParameters peuvent différer de celles du champ parameters de votre fichier manifeste. Par exemple, vous appliquez un paramètre inexistant ou vous définissez une valeur de chaîne sur un paramètre entier.