51.85. pg_settings

视图pg_settings提供对服务器运行时参数的访问。它实际上是SHOW和SET命令的替代接口。它还提供对每个参数的某些事实的访问，这些事实不能从SHOW直接获得，例如最小值和最大值。

表 51.86. pg_settings列

Name	Type	Description
name	text	运行时配置参数名称
setting	text	参数的当前值
unit	text	参数的隐式单位
category	text	参数的逻辑组
short_desc	text	参数的简要说明
extra_desc	text	参数的其他更详细的描述
context	text	设置参数值所需的上下文(请参见下文)
vartype	text	参数类型(bool，enum，integer，real或string)
source	text	当前参数值的来源
min_val	text	参数的最小允许值(非数值为空)
max_val	text	参数的最大允许值(非数值为空)
enumvals	text[]	枚举参数的允许值(非枚举值为 null)
boot_val	text	如果未另外设置参数，则在服务器启动时假定参数值
reset_val	text	RESET会将参数重置为当前会话中的值
sourcefile	text	设置当前值的配置文件(对于从配置文件以外的其他来源设置的值，或者由既不是超级用户也不是pg_read_all_settings成员的用户检查的值，则为 null)；在配置文件中使用include指令时很有帮助
sourceline	integer	配置文件中的行号，当前值设置为该值(对于从非配置文件的源设置的值，或者由既不是超级用户也不是pg_read_all_settings成员的用户检查的值，则为空)。
pending_restart	boolean	true如果配置文件中的值已更改，但需要重新启动；否则false。

context有几种可能的值。为了降低更改设置的难度，它们是：

• internal

  • 这些设置不能直接更改。它们反映了内部确定的值。通过使用不同的配置选项重建服务器，或更改提供给initdb的选项，可以调整其中的一些。

• postmaster

  • 这些设置只能在服务器启动时应用，因此任何更改都需要重新启动服务器。这些设置的值通常存储在postgresql.conf文件中，或者在启动服务器时在命令行中传递。当然，也可以在服务器启动时设置任何较低的context类型的设置。

• sighup

  • 可以在postgresql.conf中更改这些设置，而无需重新启动服务器。将 SIGHUPsignal 发送给邮局主管，以使其重新读取postgresql.conf并应用更改。邮政局长还将 SIGHUPsignal 转发给其子进程，以使它们都获取新值。

• superuser-backend

  • 可以在postgresql.conf中更改这些设置，而无需重新启动服务器。也可以在连接请求数据包中为特定会话设置它们(例如，通过 libpq 的PGOPTIONS环境变量)，但前提是连接用户是超级用户。但是，这些设置在会话启动后永远不会改变。如果您在postgresql.conf中更改它们，请将 SIGHUPsignal 发送给邮局主管，以使其重新读取postgresql.conf。新值将仅影响随后启动的会话。

• backend

  • 可以在postgresql.conf中更改这些设置，而无需重新启动服务器。也可以在连接请求包中为特定会话设置它们(例如，通过 libpq 的PGOPTIONS环境变量)；任何用户都可以对其会话进行此类更改。但是，这些设置在会话启动后永远不会改变。如果您在postgresql.conf中更改它们，请将 SIGHUPsignal 发送给邮局主管，以使其重新读取postgresql.conf。新值将仅影响随后启动的会话。

• superuser

  • 这些设置可以从postgresql.conf设置，也可以在会话中通过SET命令设置；但只有超级用户可以通过SET进行更改。 postgresql.conf中的更改仅在未使用SET构建会话本地值的情况下才会影响现有会话。

• user

  • 这些设置可以从postgresql.conf设置，也可以在会话中通过SET命令设置。允许任何用户更改其本地会话值。 postgresql.conf中的更改仅在未使用SET构建会话本地值的情况下才会影响现有会话。

有关更改这些参数的各种方法的更多信息，请参见Section 19.1。

pg_settings视图不能插入或删除，但可以更新。应用于pg_settings行的UPDATE等效于对该命名参数执行SET命令。更改仅影响当前会话使用的值。如果在事务中发出UPDATE且随后中止该事务，则回滚该事务时UPDATE命令的作用会消失。一旦提交了周围的事务，效果将一直持续到会话结束，除非被另一个UPDATE或SET覆盖。