SYSTEM VIEW · 系统视图

pg_settings

The view pg_settings provides access to run-time parameters of the server. It is essentially an alternative interface to the SHOW and SET commands. It also provides access to some facts about each parameter that are not directly available from SHOW, such as minimum and maximum values.

首次收录 PG 9.0最近收录 PG 19当前字段 17

9.0 9.1 9.2 9.3 9.4 9.5 9.6 10 11 12 13 14 15 16 17 18 19^β3

已与 PostgreSQL 18.6 实例逐字段核对 · 原始实测记录 ↗

字段结构 PostgreSQL 18

pg_settings

字段 / COLUMN	类型 / TYPE	说明 / DESCRIPTION
`name`	`text`	Run-time configuration parameter name
`setting`	`text`	Current value of the parameter
`unit`	`text`	Implicit unit of the parameter
`category`	`text`	Logical group of the parameter
`short_desc`	`text`	A brief description of the parameter
`extra_desc`	`text`	Additional, more detailed, description of the parameter
`context`	`text`	Context required to set the parameter's value (see below)
`vartype`	`text`	Parameter type (bool, enum, integer, real, or string)
`source`	`text`	Source of the current parameter value
`min_val`	`text`	Minimum allowed value of the parameter (null for non-numeric values)
`max_val`	`text`	Maximum allowed value of the parameter (null for non-numeric values)
`enumvals`	`text[]`	Allowed values of an enum parameter (null for non-enum values)
`boot_val`	`text`	Parameter value assumed at server startup if the parameter is not otherwise set
`reset_val`	`text`	Value that RESET would reset the parameter to in the current session
`sourcefile`	`text`	Configuration file the current value was set in (null for values set from sources other than configuration files, or when examined by a user who neither is a superuser nor has privileges of pg_read_all_settings); helpful when using include directives in configuration files
`sourceline`	`integer`文档原写法：`int4`	Line number within the configuration file the current value was set at (null for values set from sources other than configuration files, or when examined by a user who neither is a superuser nor has privileges of pg_read_all_settings).
`pending_restart`	`boolean`文档原写法：`bool`	true if the value has been changed in the configuration file but needs a restart; or false otherwise.

标记“隐式列”的字段不包含在 SELECT * 中；部分早期统计视图由同版本源码补全，额外来源会显示在字段说明中。

字段演化矩阵

悬停查看字段类型

存在新增 / 类型或属性变化移除

字段 / COLUMN	9.0	9.1	9.2	9.3	9.4
`name`
`setting`
`unit`
`category`
`short_desc`
`extra_desc`
`context`
`vartype`
`source`
`min_val`
`max_val`
`enumvals`
`boot_val`
`reset_val`
`sourcefile`
`sourceline`
`pending_restart`	–	–	–	–	–

9.0 是收录基线；基线中已存在的字段不标记为新增。矩阵按字段名称对齐，重命名显示为旧字段移除与新字段新增。

演化时间线

相邻大版本的变化

PostgreSQL 15 ← 14

2 处字段说明更新

PostgreSQL 10 ← 9.6

2 处字段说明更新

PostgreSQL 9.5 ← 9.4

+ pending_restart

PostgreSQL 9.1 ← 9.0

1 处字段说明更新

比较任意两个版本

起始版本 / FROM目标版本 / TO包含描述更新

选择两个版本，查看字段的新增、移除与类型变化。交互比较需要 JavaScript；演化时间线可直接阅读。