51.7. pg_file_settings#

51.7. pg_file_settings

51.7. pg_file_settings

Представление pg_file_settings предоставляет сводку содержимого конфигурационного файла(ов) сервера. В этом представлении появляется строка для каждой записи name = value, появляющейся в файлах, с аннотациями, указывающими, может ли значение быть успешно применено. Дополнительная строка(и) может появиться для проблем, не связанных с записью name = value, таких как синтаксические ошибки в файлах.

Это представление полезно для проверки, будет ли работать запланированные изменения в конфигурационных файлах или для диагностики предыдущей ошибки. Обратите внимание, что это представление отчетливо отображает текущее содержимое файлов, а не то, что было последним применено сервером. (Обычно представление pg_settings достаточно для определения этого).

По умолчанию, представление pg_file_settings может быть прочитано только суперпользователями.

Таблица 51.7. pg_file_settings Columns

Тип столбца

Описание

sourcefile text

Полное имя пути к файлу конфигурации

sourceline int4

Номер строки в конфигурационном файле, где находится запись

seqno int4

Порядок обработки записей (1..n)

name text

Имя параметра конфигурации

setting text

Значение, которое будет присвоено параметру

applied bool

True, если значение может быть успешно применено

error text

Если не равно NULL, то это означает, что произошла ошибка при применении данной записи.


Если файл конфигурации содержит синтаксические ошибки или недопустимые имена параметров, сервер не будет пытаться применять настройки из него, и, следовательно, все поля applied будут иметь значение false. В таком случае будет одна или несколько строк с ненулевыми полями error, указывающими на проблемы. В противном случае, отдельные настройки будут применяться, если это возможно. Если отдельная настройка не может быть применена (например, недопустимое значение или настройка не может быть изменена после запуска сервера), в поле error будет соответствующее сообщение. Еще один способ, при котором значение applied может быть равно false, - это переопределение более поздней записью для того же имени параметра; в этом случае это не считается ошибкой, поэтому в поле error ничего не отображается.

См. Раздел 18.1 для получения дополнительной информации о различных способах изменения параметров времени выполнения.