受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: devel

52.7. pg_file_settings #

视图pg_file_settings提供了服务器配置文件的内容摘要。 每个name = value条目在文件中出现时,此视图中会出现一行, 并附有标注,指示该值是否能够成功应用。还可能出现额外的行,用于表示与name = value条目无关的问题, 例如文件中的语法错误。

这个视图对于检查计划中的配置文件变更是否有效,或者诊断之前的故障很有帮助。 请注意,这个视图报告的是文件的当前内容,而不是服务器上最后应用的内容。 (通常可以通过pg_settings 视图确定最后一次由服务器应用的内容。)

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

Table 52.7. pg_file_settings

列类型

描述

sourcefile text

配置文件的完整路径名

sourceline int4

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

seqno int4

项被处理的顺序(1..n

name text

配置参数名

setting text

将赋给该参数的值

applied bool

如果该值能够成功应用则为真

error text

如果非空,则为说明该条目为何不能应用的错误消息


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

查看Section 19.1以获取有关更改运行时参数的各种方法的更多信息。

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。