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 et SET. 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 44.54. 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 |
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). |
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 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.