PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

53.8. pg_file_settings #

视图 pg_file_settings 提供服务器配置文件内容的 摘要。 文件中出现的每个 “name = value” 条目都会在该视图中占一行, 并带有指示该值能否被成功应用的注解。 对于与某个 “name = value” 条目无关的问题(例如文件中的语法错误), 可能会出现额外的行。

这个视图有助于检查计划中对配置文件的修改是否可行,或诊断以前的 失败。 注意,这个视图报告的是文件的 当前内容, 而不是服务器最后应用了什么。 ( pg_settings 视图通常足以确定后者。)

默认情况下,只有超级用户才能读取 pg_file_settings 视图。

Table 53.8. \1 字段列说明

Column Type

Description

sourcefile text

配置文件的完整路径名

sourceline int4

该条目在配置文件中出现的行号

seqno int4

条目被处理的顺序(1..n)

name text

Configuration parameter name

setting text

将要赋给该参数的值

applied bool

如果该值可以被成功应用则为 true

error text

如果不为空,则是指示该条目为何无法被应用的错误消息


如果配置文件包含语法错误或无效的参数名,服务器将不会尝试应用 来自它的任何设置,因此所有 applied 字段都会显示为 false。 在这种情况下,会有一行或多行具有非空的 error 字段来指出问题。 否则,各个设置会在可能的情况下被应用。 如果某个单独的设置无法被应用(例如值无效,或该设置在服务器启动 之后不能更改),它会在 error 字段中有一个相应的 消息。 条目可能出现 applied = false 的另一种情况是:它被 同一参数名的后续条目覆盖;这种情况不被视为错误,因此 error 字段中不会出现任何内容。

关于更改运行时参数的各种方法的更多信息,见 Section 19.1。