53.7. pg_file_settings #
В представлении pg_file_settings показывается сводное содержимое файлов конфигурации сервера. Для каждой имеющейся в этих файлах записи «имя = значение» это представление содержит строку с отметкой, показывающей, может ли это значение быть успешно применено. Также это представление может содержать дополнительные строки, говорящие о проблемах, не связанных с записями «имя = значение», например, синтаксических ошибках в этих файлах.
Это представление полезно для проверки, будут ли работать планируемые изменения в файлах конфигурации, или для диагностики возникшей ранее проблемы. Заметьте, что в этом представлении отражается текущее содержимое файлов, а не то, что было применено сервером в последний раз. (Чтобы получить то состояние, обычно достаточно обратиться к представлению pg_settings.)
По умолчанию представление pg_file_settings доступно только суперпользователям и только для чтения.
Таблица 53.7. Столбцы pg_file_settings
Тип столбца Описание |
|---|
Полный путь и имя файла конфигурации |
Номер строки в файле конфигурации, из которой получена эта запись |
Порядок, в котором обрабатываются записи (1.. |
Имя параметра конфигурации |
Значение, присваиваемое параметру |
True, если значение может быть применено успешно |
Сообщение об ошибке, говорящее, почему эта запись не может быть применена, либо NULL |
Если файл конфигурации содержит синтаксические ошибки или недопустимые имена параметров, сервер не будет пытаться применять никакие параметры из него, так что все поля applied будут равны False. В этом случае представление будет содержать одну или несколько строк, в которых поле error описывает проблему. Иначе отдельные записи этого файла будут применяться по возможности. Если заданное в некоторой записи присваивание выполнить нельзя (например, из-за неверного значения или если параметр нельзя изменять после запуска сервера), в поле error для неё будет записано соответствующее сообщение. Поле applied также может содержать False, если данная запись переопределяется последующей записью с тем же именем параметра; это не считается ошибкой, так что поле error будет пустым.
Чтобы узнать больше о различных способах изменения параметров времени выполнения, обратитесь к Разделу 18.1.
53.7. pg_file_settings #
The view pg_file_settings provides a summary of the contents of the server's configuration file(s). A row appears in this view for each “name = value” entry appearing in the files, with annotations indicating whether the value could be applied successfully. Additional row(s) may appear for problems not linked to a “name = value” entry, such as syntax errors in the files.
This view is helpful for checking whether planned changes in the configuration files will work, or for diagnosing a previous failure. Note that this view reports on the current contents of the files, not on what was last applied by the server. (The pg_settings view is usually sufficient to determine that.)
By default, the pg_file_settings view can be read only by superusers.
Table 53.7. pg_file_settings Columns
Column Type Description |
|---|
Full path name of the configuration file |
Line number within the configuration file where the entry appears |
Order in which the entries are processed (1.. |
Configuration parameter name |
Value to be assigned to the parameter |
True if the value can be applied successfully |
If not null, an error message indicating why this entry could not be applied |
If the configuration file contains syntax errors or invalid parameter names, the server will not attempt to apply any settings from it, and therefore all the applied fields will read as false. In such a case there will be one or more rows with non-null error fields indicating the problem(s). Otherwise, individual settings will be applied if possible. If an individual setting cannot be applied (e.g., invalid value, or the setting cannot be changed after server start) it will have an appropriate message in the error field. Another way that an entry might have applied = false is that it is overridden by a later entry for the same parameter name; this case is not considered an error so nothing appears in the error field.
See Section 18.1 for more information about the various ways to change run-time parameters.