From a97e0c3354ace5d74c6873cd5e98444757590be8 Mon Sep 17 00:00:00 2001 From: Stephen Frost Date: Fri, 8 May 2015 19:09:26 -0400 Subject: Add pg_file_settings view and function The function and view added here provide a way to look at all settings in postgresql.conf, any #include'd files, and postgresql.auto.conf (which is what backs the ALTER SYSTEM command). The information returned includes the configuration file name, line number in that file, sequence number indicating when the parameter is loaded (useful to see if it is later masked by another definition of the same parameter), parameter name, and what it is set to at that point. This information is updated on reload of the server. This is unfiltered, privileged, information and therefore access is restricted to superusers through the GRANT system. Author: Sawada Masahiko, various improvements by me. Reviewers: David Steele --- doc/src/sgml/catalogs.sgml | 78 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) (limited to 'doc/src') diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml index 4b79958b357..2756652be21 100644 --- a/doc/src/sgml/catalogs.sgml +++ b/doc/src/sgml/catalogs.sgml @@ -7559,6 +7559,11 @@ parameter settings + + pg_file_settings + file location of parameter settings + + pg_shadow database users @@ -9173,6 +9178,79 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx + + <structname>pg_file_settings</structname> + + + pg_file_settings + + + + The view pg_file_settings provides the file + name, line number and value of all parameters which are set through + configuration files. + In contrast to pg_settings, a row is provided for + each occurrence of the parameter across all configuration files. This is helpful + for discovering why one value may have been used in preference to another + when the parameters were loaded. + + + + <structname>pg_file_settings</> Columns + + + + + Name + Type + Description + + + + + sourcefile + text + Path to and name of the configration file + + + sourceline + integer + + Line number within the configuration file where the value was set + + + + seqno + integer + Order in which the setting was loaded + + + name + text + Run-time configuration parameter name + + + setting + text + value of the parameter + + + +
+ + + See for more information about the various + ways to change these parameters. + + + + The pg_file_settings view cannot be modified + directly as it represents information, as read in at server start or + reload time, about all parameter settings across all configuration files. + + + + <structname>pg_shadow</structname> -- cgit v1.2.3