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

Pour configurer un paramètre de base de données pour AlloyDB Omni, vous pouvez mettre à jour les paramètres de configuration unifiée globale (GUC) dans l'une des options suivantes:

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

  • Le fichier 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. Recherchez le fichier de configuration postgresql.conf pour votre installation d'AlloyDB Omni.

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

    Par exemple, pour appliquer l'expiration des mots 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 prennent effet. 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 la section 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 base de données à l'aide du champ parameters dans la section primarySpec du fichier manifeste de votre cluster de base 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).

Certains paramètres nécessitent de redémarrer votre cluster pour que les modifications prennent effet. Vous pouvez obtenir la liste des paramètres qui nécessitent un redémarrage à partir de pg_catalog.pg_settings. Tout paramètre avec 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 de paramètre 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 base 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.