49.73. pg_settings

La vue pg_settings fournit un accès aux paramètres d'exécution du serveur. C'est essentiellement une interface alternative aux commandes SHOW(7) et SET(7). Elle fournit aussi un accès à certaines informations des paramètres qui ne sont pas directement accessibles avec SHOW, telles que les valeurs minimales et maximales.

Tableau 49.74. Colonnes de pg_settings

Nom Type Description
name text Nom du paramètre d'exécution
setting text Valeur actuelle du paramètre
unit text Unité implicite du paramètre
category text Groupe logique du paramètre
short_desc text Description brève du paramètre
extra_desc text Information supplémentaire, plus détaillée, sur le paramètre
context text Contexte requis pour positionner la valeur du paramètre (voir ci-dessous)
vartype text Type du paramètre (bool, enum, integer, real ou string)
source text Source de la valeur du paramètre actuel
min_val text Valeur minimale autorisée du paramètre (NULL pour les valeurs non numériques)
max_val text Valeur maximale autorisée du paramètre (NULL pour les valeurs non numériques)
enumvals text[] Valeurs autorisées pour un paramètre enum (NULL pour les valeurs non enum)
boot_val text Valeur de paramètre prise au démarrage du serveur si le paramètre n'est pas positionné d'une autre façon
reset_val text Valeur à laquelle RESET ramènerait le paramètre dans la session courante
sourcefile text Fichier de configuration dans lequel ce fichier a été positionné (NULL pour les valeurs positionnées ailleurs que dans un fichier de configuration, ou quand interrogé par un utilisateur standard). Pratique quand on utilise des directives d'inclusion de configuration
sourceline integer Numéro de ligne du fichier de configuration à laquelle cette valeur a été positionnée (NULL pour des valeurs positionnées ailleurs que dans un fichier de configuration, ou quand interrogé par un non-superutilisateur).
pending_restart boolean true si la valeur a été modifiée dans le fichier de configuration mais a besoin d'un redémarrage ; ou false autrement.

Il existe différentes valeurs de context. Les voici, classées dans l'ordre de difficulté décroissante pour la modification d'un paramètre :

internal

Ces paramètres ne peuvent pas être modifiés directement ; ils reflètent des valeurs internes. Certaines sont modifiables en compilant le serveur avec des options différentes pour l'étape de configuration, ou en changeant des options lors de l'étape du initdb.

postmaster

Ces paramètres sont seulement appliqués au démarrage du serveur, donc toute modification nécessite un redémarrage du serveur. Les valeurs sont typiquement conservées dans le fichier postgresql.conf ou passées sur la ligne de commande lors du lancement du serveur. Bien sûr, tout paramètre dont la colonne context est inférieure peut aussi être configuré au démarrage du serveur.

sighup

Les modifications sur ces paramètres peuvent se faire dans le fichier postgresql.conf sans avoir à redémarrer le serveur. L'envoi d'un signal SIGHUP au processus père (historiquement appelé postmaster) le forcera à relire le fichier postgresql.conf et à appliquer les modifications. Ce processus enverra aussi le signal SIGHUP aux processus fils pour qu'ils tiennent compte des nouvelles valeurs.

superuser-backend

Les modifications de ces réglages peuvent être effectuées dans postgresql.conf sans redémarrer le serveur. Ils peuvent également être positionnés pour une session en particulier dans le paquet réseau de demande de connexion (par exemple, via la variable d'environnement PGOPTIONS de libpq), mais seulement si l'utilisateur se connectant est superutilisateur. Cependant, ces réglages ne changent jamais dans une session une fois qu'elle a débutée. Si vous les modifiez dans postgresql.conf, envoyez un signal SIGHUP à postmaster pour le forcer à relire postgresql.conf. Les nouvelles valeurs n'affecteront que les sessions ouvertes après cette relecture.

backend

Les modifications sur ces paramètres peuvent se faire dans le fichier postgresql.conf sans avoir à redémarrer le serveur ; ils peuvent aussi être configurés pour une session particulière dans le paquet de demande de connexion (par exemple, via la variable d'environnement PGOPTIONS gérée par la bibliothèque libpq) ; tous les utilisateurs peuvent faire de telles modifications pour leur session. Néanmoins, ces modifications ne changent jamais une fois que la session a démarré. Si vous les changez dans le fichier postgresql.conf, envoyez un signal SIGHUP à postmaster car ça le forcera à relire le fichier postgresql.conf. Les nouvelles valeurs affecteront seulement les sessions lancées après la relecture de la configuration.

superuser

Ces paramètres sont configurables partir du fichier postgresql.conf ou à l'intérieur d'une session via la commande SET ; mais seuls les superutilisateurs peuvent les modifier avec SET. Les modifications apportées dans le fichier postgresql.conf affecteront aussi les sessions existantes si aucune valeur locale à la session n'a été établie avec une commande SET.

user

Ces paramètres peuvent être configurés à partir du fichier postgresql.conf ou à l'intérieur d'une session via la commande SET. Tout utilisateur est autorisé à modifier la valeur sur sa session. les modifi Any user is allowed to change his session-local value. Les modifications apportées dans le fichier postgresql.conf affecteront aussi les sessions existantes si aucune valeur locale à la session n'a été établie avec une commande SET.

Voir Section 18.1, « Paramètres de configuration » pour plus d'informations sur les différentes façons de modifier ces paramètres.

La vue pg_settings n'accepte ni insertion ni suppression mais peut être actualisée. Une requête UPDATE appliquée à une ligne de pg_settings est équivalente à exécuter la commande SET(7) sur ce paramètre. Le changement affecte uniquement la valeur utilisée par la session en cours. Si un UPDATE est lancé à l'intérieur d'une transaction annulée par la suite, les effets de la commande UPDATE disparaissent à l'annulation de la transaction. Lorsque la transaction est validée, les effets persistent jusqu'à la fin de la session, à moins qu'un autre UPDATE ou SET ne modifie la valeur.