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 et les utilisateurs disposant du droit
ALTER SYSTEM sur un paramètre peuvent le modifier en
utilisant 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, identifiants, nombres ou listes 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, allow_alter_system,
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.
ALTER SYSTEM peut être désactivé en configurant
allow_alter_system à off, mais
ceci n'est pas un mécanisme de sécurité (comme expliqué en détail dans
la documentation de ce paramètre).
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.