Personnaliser les paramètres de configuration du serveur d’Azure Database pour PostgreSQL (serveur unique) à l’aide d’Azure CLI

  • Article

S’APPLIQUE À : Azure Database pour PostgreSQL – Serveur unique

Important

Azure Database pour PostgreSQL - Serveur unique est en voie de mise hors service. Nous vous recommandons vivement de procéder à une mise à niveau vers Azure Database pour PostgreSQL – Serveur flexible. Pour plus d’informations sur la migration vers Azure Database pour PostgreSQL – Serveur flexible, consultez Qu’en est-il du serveur unique Azure Database pour PostgreSQL ?.

Il est possible de lister, d’afficher et de mettre à jour les paramètres de configuration d’un serveur Azure PostgreSQL à l’aide de l’interface de ligne de commande (Azure CLI). Un sous-ensemble de configurations de moteur est exposé au niveau du serveur et peut être modifié.

Prérequis

Pour parcourir ce guide pratique, vous avez besoin des éléments suivants :

Répertorier les paramètres de configuration de Base de données Azure pour le serveur PostgreSQL

Pour répertorier tous les paramètres modifiables dans un serveur, ainsi que leurs valeurs, exécutez la commande az postgres server configuration list.

Vous pouvez répertorier les paramètres de configuration du serveur mydemoserver.postgres.database.azure.com du groupe de ressources myresourcegroup.

az postgres server configuration list --resource-group myresourcegroup --server mydemoserver

Affichage des détails des paramètres de configuration du serveur

Pour afficher les détails d’un paramètre de configuration particulier pour un serveur, exécutez la commande az postgres server configuration show.

Cet exemple affiche les détails du paramètre de configuration de serveur log_min_messages pour le serveur mydemoserver.postgres.database.azure.com du groupe de ressources myresourcegroup.

az postgres server configuration show --name log_min_messages --resource-group myresourcegroup --server mydemoserver

Modification de la valeur de paramètre de configuration du serveur

Vous pouvez également modifier la valeur d’un paramètre de configuration du serveur, ce qui a pour effet de mettre à jour la valeur de configuration sous-jacente du moteur du serveur PostgreSQL. Pour mettre à jour la configuration, exécutez la commande az postgres server configuration set.

Pour mettre à jour le paramètre de configuration de serveur log_min_messages pour le serveur mydemoserver.postgres.database.azure.com du groupe de ressources myresourcegroup.

az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver --value INFO

Si vous souhaitez réinitialiser la valeur d’un paramètre de configuration, il vous suffit de ne pas définir le paramètre --value facultatif. Le service applique alors la valeur par défaut. Dans l’exemple ci-dessus, elle peut se présenter comme suit :

az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver

Cette commande réinitialise la configuration de log_min_messages en rétablissant la valeur par défaut AVERTISSEMENT. Pour plus d’informations sur la configuration du serveur et les valeurs autorisées, consultez la documentation PostgreSQL à la rubrique Configuration du serveur.

Étapes suivantes