ALTER SYSTEM — Modifier un paramètre de configuration du serveur
ALTER SYSTEM SETparamètre_configuration
{ TO | = } {valeur
[, ...] | DEFAULT } ALTER SYSTEM RESETparamètre_configuration
ALTER 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_configuration
Nom d'un paramètre configurable. Les paramètres disponibles sont documentés dans Chapitre 20.
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 ainsi que les paramètres qui ne sont pas
autorisés dans le fichier postgresql.conf
(donc les
options préconfigurées).
Voir Section 20.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.