↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5
历史版本。 PostgreSQL 13 已结束支持。 2025-11-13. 请参阅 当前版本手册.

51.69. pg_file_settings #

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

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

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

表 51.70. 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 字段中不会出现任何内容。

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

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.