2024 年 9 月 26 日: PostgreSQL 17 发布!
支持版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不支持版本:11 / 10 / 9.6 / 9.5

52.7. pg_file_settings #

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

此视图有助于检查配置文件中的计划更改是否有效,或诊断以前发生的错误。请注意,此视图报告的是文件的 当前 内容,而不是服务器最后应用的内容。(通常,pg_settings 视图足以确定这一点。)

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

表 52.7. pg_file_settings

列 类型

描述

sourcefile text

配置文件的完整路径名

sourceline int4

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

seqno int4

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

name text

配置参数名称

setting text

要分配给参数的值

applied bool

如果该值可以成功应用,则为 True

error text

如果非空,则为错误消息,指示为什么无法应用此条目


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

有关更改运行时参数的各种方法的更多信息,请参见 第 19.1 节

提交更正

如果您在文档中看到任何不正确的内容、与您对特定功能的体验不符或需要进一步说明,请使用 此表单 报告文档问题。