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

53.8. pg_file_settings #

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

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

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

表 53.8. pg_file_settings

列 类型

描述

sourcefile text

配置文件的完整路径名

sourceline int4

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

seqno int4

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

name text

配置参数名称

setting text

要分配给参数的值

applied bool

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

error text

如果不为 null,则表示该条目未能应用的原因的错误消息


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

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

提交更正

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