pg_file_settings_云原生数据库 PolarDB(PolarDB)-阿里云帮助中心

pg_file_settings视图提供了服务器配置文件内容的概要。

简介

pg_file_settings视图提供了服务器配置文件内容的概要。该视图中的每一行表示配置文件中出现的一个“name = value”项，并带有注解指示该值是否被成功地应用。在配置文件有问题时，有可能出现额外的行，它们没有相关的“name = value”项，例如，配置文件中有语法错误。

pg_file_settings视图有助于检查在配置文件中需要的修改是否可以工作，或者用来诊断之前的失败。

说明

该视图报告是配置文件的当前内容，而不是服务器最后应用的值（这些值通常通过查看pg_settings视图即可）。
默认情况下，pg_file_settings视图只有超级用户可读。

pg_file_settings视图包含以下列信息：

列名称	类型	描述
sourcefile	text	配置文件的完整路径名。
sourceline	int4	该项在配置文件中出现的行号。
seqno	int4	项被处理的顺序（1..`n`）。
name	text	配置参数名。
setting	text	被赋予给参数的值。
applied	bool	如果被成功应用则为`true`，否则为`false`。
error	text	如果非空，表示一个错误消息，说明为什么这个项不能被应用。

如果配置文件包含语法错误或非法参数名，服务器将不会尝试从其中应用任何设置，并且因此所有的applied域都为假。在这种情况下，将会有一个或者多个行的error域为非空，它们说明了为什么出问题。否则，将尽可能应用每个设置。如果一个设置不能被应用（例如，非法值或者该设置不能在服务器开始后改变），会有一个合适的消息存储在它的error域中。一个项的applied域为假的另一种情况是它被后面一个具有相同参数名的项所覆盖，这种情况不会被认为是一种错误，因此在error域中不会有错误消息。