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 50.76. 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 :
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.
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.
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.
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.
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.
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.
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 19.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.
pg_seclabels
