ALTER SYSTEM — Modifier un paramètre de configuration du serveur
ALTER SYSTEM SETparamètre_configuration{ TO | = } {valeur[, ...] | DEFAULT } ALTER SYSTEM RESETparamètre_configurationALTER SYSTEM RESET ALL
ALTER SYSTEM est utilisé pour modifier les paramètres de
configuration du serveur pour l'instance complète. Cette méthode peut être
plus pratique que la méthode traditionnelle revenant à éditer manuellement
le fichier postgresql.conf.
ALTER SYSTEM écrit la valeur du paramètre indiqué dans
le fichier postgresql.auto.conf, qui est lu en plus du
fichier postgresql.conf. Configurer un paramètre à
DEFAULT, ou utiliser la variante
RESET, supprime le paramètre du fichier
postgresql.auto.conf. Utilisez RESET
ALL pour supprimer tous les paramètres configurés dans ce fichier.
Les nouvelles valeurs des paramètres configurés avec ALTER
SYSTEM seront prises en compte après le prochain rechargement de
la configuration ou le prochain redémarrage du serveur dans le cas des
paramètres nécessitant un redémarrage. Un rechargement de la configuration
du serveur peut se faire en appelant la fonction SQL
pg_reload_conf(), en exécutant la commande
pg_ctl reload ou en envoyant un signal
SIGHUP au processus principal du serveur.
Seuls les superutilisateurs peuvent utiliser ALTER SYSTEM.
De plus, comme cette commande agit directement sur le système de fichiers et
ne peut pas être annulée, elle n'est pas autorisée dans un bloc de
transaction et dans une fonction.
paramètre_configurationNom d'un paramètre configurable. Les paramètres disponibles sont documentés dans Chapitre 19.
valeur
Nouvelle valeur du paramètre. Les valeurs peuvent être spécifiées en tant
que constantes de chaîne, identifieurs, nombres ou liste de valeurs
séparées par des virgules, suivant le paramètre.
Les valeurs qui ne sont ni des nombres ni des identifiants valides
doivent être placées entre guillemets. DEFAULT
peut être utilisé pour supprimer le paramètre et sa valeur du fichier
postgresql.auto.conf.
Pour certains des paramètres acceptant des listes, des valeurs entre guillemets peuvent produire une sortie avec des guillemets doubles pour conserver espaces blancs et virgules ; pour les autres, les guillemets doubles doivent être utilisés à l'intérieur de chaînes comprises entre des guillemets simples pour obtenir cet effet.
Cette commande ne peut pas être utilisée pour configurer le paramètre data_directory ainsi que les paramètres qui ne sont pas
autorisés dans le fichier postgresql.conf
(donc les options préconfigurées).
Voir Section 19.1 pour d'autres façons de configurer les paramètres.
Configurer le paramètre wal_level :
ALTER SYSTEM SET wal_level = replica;
Annuler cette configuration et restaurer le paramètrage indiqué dans le
fichier postgresql.conf :
ALTER SYSTEM RESET wal_level;
La commande ALTER SYSTEM est une extension
PostgreSQL.