参数值数据类型

integer

默认值

-1,表示不限制

取值范围

-1到2147483647

参数单位

如果指定的值不带单位，则以KB为单位

参数含义

指定一个进程可以占用的最大的磁盘空间。该磁盘空间可以用于temporary files(sort及hash使用)或者持有cursor的storage file。试图超过该限制的transaction会被取消。

是否可session级修改

可以，此时仅限于superuser可以在session级修改

修改后何时生效

非session级修改Reload即可生效；Session级修改时会立即在session级生效

参数值数据类型

bool

默认值

off

取值范围

on和off

参数单位

参数含义

记录transaction的提交时间。注意：只有当这个参数是on时，函数pg_xact_commit_timestamp(xid)、pg_last_committed_xact()才能获得已提交事务的时间值。

是否可session级修改

否

修改后何时生效

重启PG instance生效

参数值数据类型

bool

默认值

off

取值范围

on和off

参数单位

参数含义

当本参数值为on时，PG会将expr=NULL(或者NULL=expr)视为expr IS NULL.本参数仅仅影响=NULL这个形式，不会影响其他形式（如in）

是否可session级修改

可以，superuser和普通用户均可以在session级修改

修改后何时生效

Reload即可生效Session级修改时会立即在session级生效

参数值数据类型

integer

默认值

1000

取值范围

64到2147483647

参数单位

参数含义

本参数用于设置每个server subprocess允许同时打开的files的最大数量。如果遇到 "Too many open files"的提示，请尝试减少本参数值。

是否可session级修改

否

修改后何时生效

重启PG instance生效。

参数值数据类型

string

默认值

空值

取值范围

参数单位

参数含义

本参数用于设置PGCluster的名字，可以用操作系统命令ps -ef| grep postgres查看该名字。该名字会出现在所有server process的开头位置，另外，对于standby连接来说，该名字还是默认的application name.

是否可session级修改

否

修改后何时生效

重启PG instance生效。

参数值数据类型

Bool

默认值

on（除windows之外的平台）；off（Windows平台）

取值范围

on和off

参数单位

参数含义

每当服务器接收到一个新的 SQL 命令时都更新process title

是否可session级修改

是，此时仅限于superuser可以在session级修改

修改后何时生效

Reload即可生效Session级修改时会立即在session级生效

参数值数据类型

string

默认值

空字符串

取值范围

参数单位

参数含义

是否可session级修改

否

修改后何时生效

参数值数据类型

integer

默认值

0

取值范围

0到1000000

参数单位

参数含义

是否可session级修改

否

修改后何时生效

参数值数据类型

integer

默认值

4

取值范围

0到262143

参数单位

参数含义

本参数设置Logical replication workers进程的最大数量，此处的worker进程包括两种：apply workers 和table synchronization workers。Logical replication workers进程的数量从max_worker_processes配置参数定义的池中获取。

是否可session级修改

否

修改后何时生效

重启PG instance生效。

参数值数据类型

integer

默认值

2

取值范围

0到262143

参数单位

参数含义

指定了每个subscription中synchronization workers的最大数量。本参数控制在subscription初始化 或者 新表加入时的initial data copy的并行度。目前，每个table只能指定一个synchronization workersynchronization workers从max_logical_replication_workers配置参数定义的池中取得。

是否可session级修改

否

修改后何时生效

Reload即可生效。

参数值数据类型

string

默认值

空字符串

取值范围

参数单位

参数含义

是否可session级修改

否

修改后何时生效

重启PG instance生效。

参数值数据类型

string

默认值

空字符串

取值范围

参数单位

参数含义

是否可session级修改

否

修改后何时生效

参数值数据类型

String

默认值

空字符串

取值范围

参数单位

参数含义

本参数用于定义在recovery结束时候的需要执行的shell命令。如果命令返回非零值，一个警告日志消息会被写入，然后数据库会继续启动。一个例外是：当命令被一个signal终止或者shell中错误时，数据库不会继续启动。%r代表最后一个有效的restart point的wal file

是否可session级修改

否

修改后何时生效

Reload即可生效。

参数值数据类型

Bool

默认值

off

取值范围

on和off

参数单位

参数含义

是否可session级修改

是

修改后何时生效

Reload即可生效Session级别修改可以立即生效。

参数值数据类型

bool

默认值

on

取值范围

参数单位

参数含义

当设置为on时，PostgreSQL会在backend crash之后重新初始化(即:restart)。在某些情况下，比如PostgreSQL被Clusterware调用时，需要禁用PostgreSQL的restart(将该参数值设置为off)以便clusterware获得PostreSQL的控制权并采取适当的操作。

是否可session级修改

否

修改后何时生效

参数值数据类型

bool

默认值

off

取值范围

off 和on

参数单位

参数含义

如果设置为off(默认值),当PostgreSQL flush数据到文件系统上遇到failure时，PostgreSQL会抛出一个panic级别的error。这会导致数据库服务crash掉。本参数只能在数据库服务启动之前设置。在某些操作系统中，当回写(write-back)失败之后，kernel的page cache中的数据状态是未知的(unknown).在一些情况下，它可能会被完全忘记，设置为尝试是不安全的，在实际上数据已经丢失的情况下，第二次尝试可能会报告成功，在这些场景中，避免数据损失的唯一方法是解决掉硬件问题之后从wal中恢复。当设置为on时，PostgreSQL会报告一个error并会继续运行，data flushing操作会在稍后的checkpoint中尝试。注意：仅在调查操作系统对buffered data的处理以防回写失败的情况下，才将其设置为on。

是否可session级修改

否

修改后何时生效

重启PG instance生效。

参数值数据类型

enum

默认值

off

取值范围

off,on,always

参数单位

参数含义

指定归档模式。on表示启用归档模式，当wal_level配置参数值为minimal时, archive_mode 不能设置为on。当本参数值设置为always时，standby 实例会为收到的每个wal segments调用归档命令,也就是standby实例上也会进行wal的归档操作。本参数仅仅能在pg启动时设置

是否可session级修改

否

修改后何时生效

参数值数据类型

string

默认值

空字符串

取值范围

参数单位

参数含义

是否可session级修改

否

修改后何时生效

参数值数据类型

integer

默认值

0

取值范围

0到1073741823

参数单位

若是不指定单位，那默认的单位是秒

参数含义

强制进行wal segments归档的时长。使用本参数归档出来的wal segment与正常的wal segment是相同的大小。因此，本参数值设置太小会对存储空间有浪费。本参数可以在postgresql.conf或者server command line设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

参数值数据类型

integer

默认值

200

取值范围

10到10000

参数单位

若是不指定单位，那默认的单位是毫秒(ms)

参数含义

在每一轮循环中，background writer都会为一定数量的脏缓冲区发出写操作，然后background writer进行睡眠，睡眠的时间为bgwriter_delay参数值，然后再唤醒，然后重复。设置bgwriter_delay为不是10的倍数的值可能与将其设置为10的下一个更高的倍数具有相同的结果。本参数可以在postgresql.conf或者server command line设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

参数值数据类型

integer

默认值

100

取值范围

0到1073741823

参数单位

参数含义

每轮bgwriter进程写入LRU Page的最大数量。本参数设置为零会禁用background writing行为，但是background writer进程依然会存在。本参数可以在postgresql.conf或者server command line设置

是否可session级修改

否

修改后何时生效

参数值数据类型

real

默认值

2.0

取值范围

0到10

参数单位

参数含义

每轮写dirty buffer的数量基于服务器进程(即:backend process)在最近几轮中所需要的新buffer数量。最近的平均需要量乘以本参数值就是下一轮需要的新buffers数量的估计值。Dirty buffers会一直写入，直到有那么多干净的、可重用的buffers为止。因此，本参数值为1.0表示准确预计了需要的buffers数量。较大的本参数值提供了一些缓冲，以防需求激增，而较小的本参数值会有意将写dirty buffers操作留给服务器进程(即:backend process)完成。本参数可以在postgresql.conf或者server command line设置

是否可session级修改

否

修改后何时生效

Reload即可生效

参数值数据类型

integer

默认值

Linux平台下是64，也就是512KB；其他平台下是0

取值范围

源码中BLCKSZ 符号常量为8KB时，取值范围是0到256；源码中BLCKSZ 符号常量不为8KB时，等比例计算即可。

参数单位

8KB

参数含义

当background writer写入的数据量超过本参数值之后，尝试强制操作系统发送这些写入的数据到底层存储中。这么做会限制kernel中page cache的dirty data的数量，减少在checkpoint末尾发生fsync时发生卡顿的可能性。本参数可以在postgresql.conf或者server command line设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

bool

默认值

off

取值范围

off和on

参数单位

参数含义

在本参数设置为on的情况下，pg会向运行日志中写入系统性能统计信息。本参数on时，其他参数（log_parser_stats 、log_planner_stats、log_executor_stats）必须设置为off在本参数设置为on的情况下，当前台发出SQL语句时（如下以psql中执行select \* from pg_database为例子），在pg的运行日志中，会有如下的输出： 2021-03-31 09:55:21.621 CST,"pg131","postgres",8896,"[local]",6063d5a4.22c0,6,"",2021-03-31 09:51:32 CST,3/0,0,LOG,00000,"QUERY STATISTICS","! system usage stats: ! 0.000657 s user, 0.000000 s system, 0.000657 s elapsed ! [0.003464 s user, 0.001403 s system total] ! 6288 kB max resident size ! 0/8 [0/24] filesystem blocks in/out ! 0/128 [0/1295] page faults/reclaims, 0 [0] swaps ! 0 [0] signals rcvd, 0/0 [0/0] messages rcvd/sent! 0/0 [11/2] voluntary/involuntary context switches",,,,,"select \*from pg_database;",,,"psql","client backend"

是否可session级修改

是

修改后何时生效

Session级修改立即生效；非session级修改reload生效，仅仅superuser能修改本参数

数据类型

bool

默认值

off

取值范围

off和on

参数单位

参数含义

在本参数设置为on的情况下，pg会向运行日志中写入解析统计信息。在本参数设置为on的情况下，log_statement_stats配置参数无法设置为on，设置为on时会有如下的错误： postgres=# alter system set log_statement_stats='on'; ERROR: invalid value for parameter "log_statement_stats": 1 DETAIL: Cannot enable "log_statement_stats" when "log_parser_stats", "log_planner_stats", or "log_executor_stats" is true. postgres=#在本参数设置为on的情况下，当前台发出SQL语句时（如下以psql中执行select \* from pg_database为例子），在pg的运行日志中，会有如下的输出： 2021-03-31 10:16:25.962 CST,"pg131","postgres",8896,"[local]",6063d5a4.22c0,41,"",2021-03-31 09:51:32 CST,3/3486,0,LOG,00000,"PARSER STATISTICS","! system usage stats: ! 0.000019 s user, 0.000000 s system, 0.000019 s elapsed ! [0.015481 s user, 0.001403 s system total] ! 7720 kB max resident size ! 0/0 [0/56] filesystem blocks in/out ! 0/0 [0/1673] page faults/reclaims, 0 [0] swaps ! 0 [0] signals rcvd, 0/0 [0/0] messages rcvd/sent ! 0/0 [39/6] voluntary/involuntary context switches",,,,,"select \* from pg_database;",,,"psql","client backend" 2021-03-31 10:16:25.962 CST,"pg131","postgres",8896,"[local]",6063d5a4.22c0,42,"",2021-03-31 09:51:32 CST,3/3486,0,LOG,00000,"statement: select \* from pg_database;",,,,,,,,,"psql","client backend" 2021-03-31 10:16:25.962 CST,"pg131","postgres",8896,"[local]",6063d5a4.22c0,43,"",2021-03-31 09:51:32 CST,3/3486,0,LOG,00000,"PARSE ANALYSIS STATISTICS","! system usage stats: ! 0.000031 s user, 0.000000 s system, 0.000030 s elapsed ! [0.015565 s user, 0.001403 s system total] ! 7720 kB max resident size ! 0/0 [0/56] filesystem blocks in/out ! 0/0 [0/1673] page faults/reclaims, 0 [0] swaps ! 0 [0] signals rcvd, 0/0 [0/0] messages rcvd/sent ! 0/0 [39/6] voluntary/involuntary context switches",,,,,"select \* from pg_database;",,,"psql","client backend" 2021-03-31 10:16:25.962 CST,"pg131","postgres",8896,"[local]",6063d5a4.22c0,44,"",2021-03-31 09:51:32 CST,3/3486,0,LOG,00000,"REWRITER STATISTICS","! system usage stats: ! 0.000003 s user, 0.000000 s system, 0.000003 s elapsed ! [0.015582 s user, 0.001403 s system total] ! 7720 kB max resident size ! 0/0 [0/56] filesystem blocks in/out ! 0/0 [0/1673] page faults/reclaims, 0 [0] swaps ! 0 [0] signals rcvd, 0/0 [0/0] messages rcvd/sent! 0/0 [39/6] voluntary/involuntary context switches",,,,,"select \* from pg_database;",,,"psql","client backend"

是否可session级修改

是，但是不能在log_statement_stats=on时设置本参数为on

修改后何时生效

Session级修改立即生效非session级修改reload生效，仅仅superuser能修改本参数

参数值数据类型

boolean

默认值

off

取值范围

off和on

参数单位

参数含义

在本参数设置为on的情况下，pg会向运行日志中写入规划器统计信息。在本参数设置为on的情况下，log_statement_stats配置参数无法设置为on，设置为on时会有如下的错误： postgres=# alter system set log_statement_stats='on'; ERROR: invalid value for parameter "log_statement_stats": 1 DETAIL: Cannot enable "log_statement_stats" when "log_parser_stats", "log_planner_stats", or "log_executor_stats" is true. postgres=#在本参数设置为on的情况下，当前台发出SQL语句时（如下以psql中执行select \* from pg_database为例子），在pg的运行日志中，会有如下的输出： 2021-03-31 10:24:39.323 CST,"pg131","postgres",8896,"[local]",6063d5a4.22c0,63,"",2021-03-31 09:51:32 CST,3/3491,0,LOG,00000,"PLANNER STATISTICS","! system usage stats: ! 0.000041 s user, 0.000006 s system, 0.000045 s elapsed ! [0.017384 s user, 0.002173 s system total] ! 7740 kB max resident size ! 0/0 [0/80] filesystem blocks in/out ! 0/0 [0/1674] page faults/reclaims, 0 [0] swaps ! 0 [0] signals rcvd, 0/0 [0/0] messages rcvd/sent! 0/0 [55/10] voluntary/involuntary context switches",,,,,"select \* from pg_database;",,,"psql","client backend"

是否可session级修改

是，但是不能在log_statement_stats=on时设置本参数为on

修改后何时生效

Session级修改立即生效;非session级修改reload生效，仅仅superuser能修改本参数

参数值数据类型

Bool

默认值

off

取值范围

off和on

参数单位

参数含义

在本参数设置为on的情况下，pg会向运行日志中写入执行器统计信息。在本参数设置为on的情况下，log_statement_stats配置参数无法设置为on，设置为on时会有如下的错误： postgres=# alter system set log_statement_stats='on'; ERROR: invalid value for parameter "log_statement_stats": 1 DETAIL: Cannot enable "log_statement_stats" when "log_parser_stats", "log_planner_stats", or "log_executor_stats" is true. postgres=#在本参数设置为on的情况下，当前台发出SQL语句时（如下以psql中执行select \* from pg_database为例子），在pg的运行日志中，会有如下的输出： 2021-03-31 10:27:59.858 CST,"pg131","postgres",8896,"[local]",6063d5a4.22c0,71,"",2021-03-31 09:51:32 CST,3/3496,0,LOG,00000,"EXECUTOR STATISTICS","! system usage stats: ! 0.000031 s user, 0.000000 s system, 0.000030 s elapsed ! [0.018581 s user, 0.003320 s system total] ! 7744 kB max resident size ! 0/0 [0/104] filesystem blocks in/out ! 0/0 [0/1676] page faults/reclaims, 0 [0] swaps ! 0 [0] signals rcvd, 0/0 [0/0] messages rcvd/sent! 0/0 [71/14] voluntary/involuntary context switches",,,,,"select \* from pg_database;",,,"psql","client backend"

是否可session级修改

是，但是不能在log_statement_stats=on时设置本参数为on

修改后何时生效

Session级修改立即生效非session级修改reload生效，仅仅superuser能修改本参数

数据类型

string

默认值

llvmjit

取值范围

参数单位

参数含义

本参数值指定了jit provider library的名称，本参数仅仅可以在pg启动时设置。若是指定了不存在的library，则jit不可用，但是不会有报错抛出。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

string

默认值

空字符串

取值范围

参数单位

参数含义

本参数指定在连接启动时被预加载的一个或多个共享库。多个库名称以逗号分隔，其中每个库名的解释与load命令相同。库名之间的空格会被忽略，若是需要在库名中包括空格或者逗号，请用双引号将库名引起来。参数值仅仅在连接开始时生效，后续更改无效。如果找不到指定的库，则连接会将失败(即:连接将无法登陆到数据库中)。本参数任何user都可以设置。因此，被加载的共享库仅仅限于在$libdir/plugins目录下。数据库管理员有责任确保该目录下的共享库的安全性。本参数的参数值可以明确指定目录，比如$libdir/plugins/mylib，或者仅仅指定library名称，比如mylib，mylib的作用等同于$libdir/plugins/mylib本参数的目的是允许非授权用户加载debugging或者performance-measurement 库到特定session中，而无需load命令。为此，可以在客户端上使用设置了本参数的PGOPTIONS环境变量或者使用alter role set

是否可session级修改

是

修改后何时生效

Session级修改立即生效非session级修改reload生效

数据类型

string

默认值

空字符串

取值范围

参数单位

参数含义

本参数值指定了在连接启动时被预加载的一个或者多个共享库。多个库名称以逗号分隔，其中每个库名的解释与load命令相同。库名之间的空格会被忽略，若是需要在库名中包括空格或者逗号，请用双引号将库名引起来。参数值仅仅在连接开始时生效，后续更改无效。如果找不到指定的库，则连接会将失败(即:连接将无法登陆到数据库中)。本参数的目的是允许加载debugging或者performance-measurement 库到特定session中，而无需load命令。比如，使用alter role set 语句设置本参数可以将auto_explain针对所有session生效。与shared_preload_libraries不同，在会话开始时（而不是在首次使用时）加载库没有太大的性能优势。但是，使用连接池时有一些优点。

是否可session级修改

可以，只有superuser可以改变本参数值

修改后何时生效

Session级修改立即生效非session级修改reload生效，reload之后，仅仅对新启动的session生效。

数据类型

string

默认值

空字符串

取值范围

参数单位

参数含义

本参数值指定了在PostgreSQL数据库启动时被预加载的一个或者多个共享库。多个库名称以逗号分隔，其中每个库名的解释与load命令相同。库名之间的空格会被忽略，若是需要在库名中包括空格或者逗号，请用双引号将库名引起来。该参数只能在PostgreSQL数据库启动时设置，若是找不到指定的库，PostgreSQL数据库启动会失败。设置了本参数之后，新的backend process的启动时间会略有延长，即使这个backedn process不用这个共享库。因此，本参数推荐用于哪些在绝大多数session中使用的共享库。另外，由于本参数需要重启PostgreSQL数据库生效，因此，若是用于短期的debugging目的，请使用session_preload_libraries参数。请注意，在Windows主机上，在服务器启动时预加载库不会减少启动每个新服务器进程所需的时间。每个服务器进程将重新加载所有预加载库。但是，对于需要在postmaster启动时执行操作的库，本参数在windows主机上是很有用的。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

string

默认值

1000

取值范围

1到2147483647

参数单位

毫秒

参数含义

在检查是否存在deadlock条件之前，等待一个lock的时间长度。死锁检查是相对昂贵的，因此，pg不会在每次等待lock时都运行死锁检测。PostgreSQL会乐观的认为死锁在生产应用程序中并不常见，只需要等待一段时间后再检查死锁。这是您在实践中想要设置的最小值，在负载很重的pg中，可能需要提高本参数值。在理想情况下，本参数值应该超过典型的transaction 时间，以提高在PostgreSQL决定检查死锁之前将释放锁的几率。仅仅superuser可以修改本参数值。在log_lock_waits参数启用的情况下，deadlock_timeout参数值也决定了一个有关lock wait的 log message被写入运行日志之前的等待时间。如果你正在尝试调查锁定延迟(locking delays)，你可能希望设置比正常deadlock_timeout参数值更短的时间。

是否可session级修改

是(仅仅superuser可修改)

修改后何时生效

Session级修改立即生效(仅仅superuser)；非session级别修改Reload即可生效

数据类型

integer

默认值

64

取值范围

10到2147483647

参数单位

参数含义

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

Integer

默认值

64

取值范围

10到2147483647

参数单位

参数含义

共享谓词锁表(shared predicate lock table)追踪max_pred_locks_per_transaction \* (max_connections + max_prepared_transactions) 个lock objects，因此，一次只能锁定这么多不同的对象。本参数控制分配给每个事务的object lock的平均数量。单个事务可以锁定更多的对象，只要所有事务的锁都在锁表(lock table)中. 本参数值不是可以锁定的行数；可以锁定的行数是无限的。本参数默认值64在测试环境中是足够的，但是如果你的client在单个串行化事务中用到了多个不同的table，你可能需要加大本参数值。本参数只能在PostgreSQL数据库启动时设置。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

Integer

默认值

-2

取值范围

-2147483648到2147483647

参数单位

参数含义

本参数控制在将锁提升为覆盖整个relation之前，单个relation中能有多少pages或者tuples能被predicate-locked 。本参数值大于等于零时表示绝对限制，本参数值为负值时表示max_pred_locks_per_transaction/本参数值的绝对值。本参数可以在postgresql.conf设置也可以在server command line设置。

是否可session级修改

否

修改后何时生效

Reload生效

数据类型

integer

默认值

2

取值范围

0到2147483647

参数单位

参数含义

本参数控制在将锁提升为覆盖整个page之前，单个page中能有多少tuples能被predicate-locked。本参数可以在postgresql.conf设置也可以在server command line设置。

是否可session级修改

否

修改后何时生效

Reload生效

数据类型

Real

默认值

0，零代表禁用了基于成本的vacuum delay特性。

取值范围

0到100

参数单位

毫秒

参数含义

vacuum_cost_limit参数值是一个累积vacuum io操作的成本值，当vacuum操作达到vacuum_cost_limit参数值之后，vacuum操作会停下来休眠一段时间，该段时间是vacuum_cost_delay参数值指定的，然后，PostgreSQL会重置计数器并继续vacuum操作。本参数的参数值建议尽量小，大值是没有帮助的。

是否可session级修改

是

修改后何时生效

session修改会立即生效；非session级修改reload即可生效。

数据类型

Integer

默认值

1

取值范围

0到10000

参数单位

参数含义

对shared buffer中发现的一个buffer进行vacuum的估计成本，本成本代表：锁定buffer pool的成本+查找shared hash table的成本+扫描page中内容的成本。

是否可session级修改

是

修改后何时生效

session修改会立即生效;非session级修改reload即可生效。

数据类型

Integer

默认值

10

取值范围

0到10000

参数单位

参数含义

对不在shared buffer中的一个buffer(只能从disk读取)进行vacuum的估计成本,本成本代表：锁定buffer pool的成本+查找shared hash table的成本+从disk中读取该block到buffer的成本+扫描page中内容的成本。

是否可session级修改

是

修改后何时生效

session修改会立即生效;非session级修改reload即可生效。

数据类型

Integer

默认值

20

取值范围

0到10000

参数单位

参数含义

Vacuum改变一个之前是干净的block的估计成本。本成本代表：额外的io操作以便将dirty block刷新到disk中。

是否可session级修改

是

修改后何时生效

session修改会立即生效；非session级修改reload即可生效。

数据类型

Integer

默认值

200

取值范围

1到10000

参数单位

参数含义

本参数值是一个累积vacuum io操作的成本值，当vacuum操作达到本参数值之后，vacuum操作会停下来休眠一段时间。

是否可session级修改

是

修改后何时生效

session修改会立即生效；非session级修改reload即可生效。

数据类型

Integer

默认值

10

取值范围

0到262143，0表示复制被禁用

参数单位

参数含义

同时运行wal sender process的最大数量。运行wal sender process的场景包括流复制和以streaming模式进行base backup(译者注：其实还包括逻辑复制使用逻辑复制槽的场景，但是在PostgreSQL文档中并没有写明这一点)。本参数仅能在PostgreSQL启动时进行设置。配置参数waL_level必须设置为replica或者更高的值以便允许来自standby server的连接。在流复制环境中，在流复制备库上的该参数值至少要等于或者大于流复制主库上的该参数值，否则在备库上的query是不允许的。

是否可session级修改

否

修改后何时生效

重启PG instanc生效

数据类型

Integer

默认值

10

取值范围

0到262143

参数单位

参数含义

是否可session级修改

否

修改后何时生效

重启PG instanc生效

数据类型

Integer

默认值

0，0表示PostgreSQL不会为流复制环境保留额外的wal segments，

取值范围

0到2147483647

参数单位

MB，若是设置时不带单位，则默认为MB

参数含义

指定在pg_wal目录中保留的wal segment file的最小大小，以便流复制环境中的standby server 从主库中fetch wal file。如果连接到发送服务器的standby server超过本参数值的大小，发送服务器可能会删除掉standby server仍然需要的wal segments，此时，复制连接会终止，下游的连接最终也会因此失败，若是wal进行了归档，standby server可以从归档中进行fetch segments，以便恢复流复制。本参数值仅仅设置保留在pg_wal中的wal segments的最小大小。系统可能需要保留更多的wal segments以便进行wal 归档或者从检查点中恢复。本参数值仅仅在postgresql.conf中进行设置或者在server command line中进行设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

Integer

默认值

-1，-1表示复制槽保留不限数量的wal files。

取值范围

-1到2147483647

参数单位

MB

参数含义

用来指定复制槽保留pg_wal目录中wal file的最大大小。当一个复制槽的restart_lsn落后于current_lsn超过本参数值时，使用了复制槽的standby server不能再继续流复制，因为已经删除掉了需要的wal files

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

Integer

默认值

60000

取值范围

0到2147483647，0代表禁用timeout机制。

参数单位

毫秒，若是指定时不带单位，默认为为毫秒数

参数含义

当处于inactive状态多长时间(多长时间由本参数指定)之后，终止掉复制连接。这对于发送服务器检测standby crash或者网络中断很有用。当主备节点分布于不同的地理位置时，不同地理位置的节点使用不同的本参数值会带来管理上的灵活性。对于低延迟网络连接，较小的本参数值有助于快速的连接故障检测；对于地理位置较远的高延迟网络连接，较高的本参数值有助于判断standby server的健康状况。

是否可session级修改

是

修改后何时生效

Session修改立即生效，允许非superuser修改本参数值非session级修改reload生效。

数据类型

Integer

默认值

60

取值范围

1到600

参数单位

秒，如果指定本参数值时不带单位，默认为秒

参数含义

允许完成连接认证的最长时间。如果客户端没有在本参数值指定的时间内完成连接认证，PostgreSQL数据库会关闭此次连接。本参数用于防止大量的客户端无限制的占用连接。本参数仅仅可以在postgresql.conf设置或者在server command line设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

enum

默认值

md5

取值范围

md5和scram-sha-256，写on也可以，on与md5有相同的作用。

参数单位

参数含义

本参数决定了create role或者alter role语句中指定的密码的加密算法。请注意，老的客户端版本不支持SCRAM-SHA-256密码加密算法，具体请见下面的描述。有两个关键的标准去确定是否支持SCRAM密码加密算法。 正在运行PostgreSQL 10及其更高版本 你用来连接到PostgreSQL数据库的驱动有SCRAM兼容性。PostgreSQL社区已经提供了一个驱动清单(https://wiki.postgresql.org/wiki/List_of_drivers#Drivers)如果您的系统满足上述两个标准，您可以使用SCRAM密码加密算法。请注意：要把现有的环境从md5升级到scram-sha-256，可以在确保所有在用的客户端已经足以支持SCRAM之后，在postgresql.conf中设置password_encryption = 'scram-sha-256'，然后让所有用户设置新口令并且在pg_hba.conf中将认证方法说明改为scram-sha-256。

是否可session级修改

是

修改后何时生效

Session级修改立即生效；非session级修改reload生效

数据类型

string

默认值

FILE:<sysconfdir>/krb5.keytab，注意,sysconfdir代表sysconfdir目录，该目录可以用pg_config --sysconfdir操作系统命令获得。

取值范围

参数单位

参数含义

设置服务器Kerberos key file的位置。如果本参数设置为空字符串(empty string),PostgreSQL会忽略这个空字符串，此时系统默认值会被使用。本参数值在postgresql.conf或者server command line中设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

bool

默认值

off，off代表大小写敏感

取值范围

参数单位

参数含义

本参数用于控制GSSAPI user names是否被视为大小写不敏感，本参数值仅能在postgresql.conf或者server command line中设置

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

bool

默认值

off

取值范围

off和on

参数单位

参数含义

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

boolean

默认值

on

取值范围

on 和off

参数单位

参数含义

当设置为on时，当每个session中执行SQL语句或者命令时，PostgreSQL会收集信息（包括命令执行的时间信息）。收集的信息仅仅对superuser和执行命令所在session的owner可见。

是否可session级修改

是，仅限于superuser可进行session级修改

修改后何时生效

Session级修改立即生效;非session级修改reload生效

数据类型

Integer

默认值

1024

取值范围

100到1048576

参数单位

Byte，当指定本参数不带单位时，默认是Bytes

参数含义

为每个active的session保留当前执行命令的文本的大小，该文本对应pg_stat_activity.query列。本参数仅仅能在PostgreSQL start时设置

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

Bool

默认值

on

取值范围

on和off

参数单位

参数含义

当设置为on时，针对database activity收集统计信息。Autovacuum进程需要这些收集的信息。

是否可session级修改

是，仅限于superuser可进行session级修改

修改后何时生效

Session级修改立即生效；非session级修改reload生效

数据类型

bool

默认值

off

取值范围

off和on

参数单位

参数含义

是否为database中的 io call/activity启用计时（即:io操作消耗了多少时间）。io计时信息体现在如下方面： pg_stat_database中 explain 带buffer时的输出中 pg_stat_statements中当设置为on时,PostgreSQL会重复查询操作系统的当前时间，这个可能会导致在某些平台下有大量开销。您可以使用pg_test_timing工具(该工具在bin目录下)来衡量系统的计时开销。仅superuser可以更改本参数值

是否可session级修改

是，仅限于superuser可进行session级修改

修改后何时生效

Session级修改立即生效非session级修改reload生效

数据类型

enum

默认值

none，none的含义是禁用本功能

取值范围

none,pl,all

参数单位

参数含义

启用追踪函数调用计数和消耗的时间。参数值pl的含义是仅仅对procedural-language函数进行追踪，参数值all的含义是追踪SQL和C语言函数。仅superuser可以更改本参数值

是否可session级修改

是，仅限于superuser可进行session级修改

修改后何时生效

Session级修改立即生效；非session级修改reload生效

数据类型

string

默认值

pg_stat_tmp

取值范围

参数单位

参数含义

本参数值用于指定存储临时统计信息的目录。本参数值可以是绝对路径，也可以是相对于data directory的相对路径本参数值指定为基于RAM的文件系统会减少物理IO并提升性能。本参数仅能在postgresql.conf中设置或者在server command line设置。

是否可session级修改

否

修改后何时生效

Reload生效

数据类型

string

默认值

取值范围

参数单位

参数含义

本参数值表示PostgreSQL的数据目录的位置

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

string

默认值

在数据目录中

取值范围

参数单位

参数含义

本参数值指定了postgresql.conf的位置本参数值仅仅可以在postgres command line设置

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

string

默认值

在数据目录中

取值范围

参数单位

参数含义

本参数值指定了pg_hba.conf的位置；本参数值仅仅可以在PostgreSQL启动时设置

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

string

默认值

在数据目录中

取值范围

参数单位

参数含义

本参数值指定了pg_ident.conf的位置本参数值仅仅可以在PostgreSQL启动时设置

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

string

默认值

空字符串

取值范围

参数单位

参数含义

指定了将postmaster的pid写入哪个文件本参数值仅仅可以在PostgreSQL启动时设置。 postgres=# alter system set external_pid_file='/home/pg131/postmasterpid.txt'; ALTER SYSTEM postgres=# exit [pg131@VM-0-8-centos ~]$ pg_ctl restart waiting for server to shut down…​. done server stopped waiting for server to start…​.2021-04-09 10:09:21.776 CST [5977] LOG: redirecting log output to logging collector process 2021-04-09 10:09:21.776 CST [5977] HINT: Future log output will appear in directory "log". done server started [pg131@VM-0-8-centos ~]$ cd [pg131@VM-0-8-centos ~]$ ll total 136260 -rw-rw-r-- 1 pg131 pg131 0 Mar 10 20:47 12345aa drwxrwxr-x 2 pg131 pg131 4096 Apr 9 10:09 archive drwx------ 20 pg131 pg131 4096 Apr 9 10:09 data -rw-rw-r-- 1 pg131 pg131 72 Mar 23 10:34 para.sql drwxrwxr-x 6 pg131 pg131 4096 Dec 20 14:32 postgresql-13.1 -rw-r—​r-- 1 pg131 pg131 139499520 Dec 20 14:07 postgresql-13.1.tar -rw-r—​r-- 1 pg131 pg131 5 Apr 9 10:09 postmasterpid.txt drwxrwxr-x 7 pg131 pg131 4096 Dec 20 14:45 soft drwx------ 3 pg131 pg131 4096 Dec 20 16:04 ts1 [pg131@VM-0-8-centos ~]$ cat postmasterpid.txt 5977 [pg131@VM-0-8-centos ~]$ pg_ctl status pg_ctl: server is running (PID: 5977) /home/pg131/soft/bin/postgres[pg131@VM-0-8-centos ~]$

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

enum

默认值

warning

取值范围

debug5,debug4,debug3,debug2,debug1,info,notice,warning,error,log,fatal,panic

参数单位

参数含义

控制哪种message level写入系统日志。取值范围见上。在上面的取值范围中，前一个取值包括其后的取值。在上面的取值范围中，级别越在后边，写入系统日志中的messages就越少。注意: 本参数的参数值log的级别与client_min_messages配置参数的参数值log的级别不同。仅允许superuser可以修改本参数值。

是否可session级修改

是，此时仅限于superuser在session级别修改

修改后何时生效

Session级别修改立即生效；其他级别修改reload生效

数据类型

enum

默认值

error，表示那些导致了errors、log messages、fatal errors、panics的SQL语句会被记录到日志中。

取值范围

debug5,debug4,debug3,debug2,debug1,info,notice,warning,error,log,fatal,panic

参数单位

参数含义

控制导致何种级别错误的SQL语句内容被记录到日志中。为了关闭对错误SQL语句的记录，请设置被参数值为panic仅允许superuser可以修改本参数值。

是否可session级修改

是，此时仅限于superuser在session级别修改

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

integer

默认值

-1，-1表示禁用本功能。

取值范围

-1到2147483647

参数单位

毫秒，若是不指定单位的话。

参数含义

所有运行超过本参数值的SQL语句会打印到系统日志中。本参数对追踪未优化的SQL语句有很大帮助。本参数值为零表示打印所有的SQL语句。仅允许superuser可以修改本参数值。本参数会覆盖log_min_duration_sample参数，这意味持续时间超过本参数值的SQL语句将不进行采样，而是始终记录下来。对于使用扩展查询协议的客户端，Parse、Bind、Execute阶段会被各自独立记录下来。本参数与log_statement参数合用时，由于log_statement参数起作用而记录到log中的SQL文本不会被重复记录。在不使用syslog时，推荐使用log_line_prefix参数，以便记录PID或者Session ID。

是否可session级修改

是，此时仅限于superuser在session级别修改

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

Integer

默认值

-1，-1表示禁用本功能。

取值范围

-1到2147483647，参数值为零时，记录所有语句的sample

参数单位

毫秒

参数含义

举例说明，如果本参数值设置为100ms，那么运行时间超过100ms的SQL语句会被考虑进行采样。仅允许superuser可以修改本参数值。当流量太大而无法记录所有查询时，启用此参数会很有帮助。本参数的优先级比log_min_duration_statement参数优先级要低。这意味着持续时间超过log_min_duration_statement参数值的SQL语句不受采样限制，并且总是被记录下来。

是否可session级修改

是，此时仅限于superuser在session级别修改

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

Real

默认值

1

取值范围

0到1

参数单位

参数含义

确定将记录的持续时间超过log_min_duration_sample参数值的的语句的比率。例如0.5意味着统计上每两个给定语句中就有一个被记录的机会。默认值为1.0，意味着记录所有采样语句。本参数值设置为0表示禁用sampled statement-duration logging。仅允许superuser可以修改本参数值。

是否可session级修改

是，此时仅限于superuser在session级别修改

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

Real

默认值

0，参数值为0表示不记录任何其他事务的语句

取值范围

0到1，参数值为1表示记录所有事物的所有语句

参数单位

参数含义

设置除其他原因记录的语句之外，所有记录语句的事务的百分比，本参数适用于每个新事务，而不考虑其语句的持续时间。采样是随机的，例如0.1意味着在统计上，每十个交易中有一个机会记录任何给定的事务。本参数值有助于构建一个事务的采样。仅允许superuser可以修改本参数值。另外请注意：与所有statement-logging选项一样，本参数会显著增加系统负载。

是否可session级修改

是，此时仅限于superuser在session级别修改

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

Integer

默认值

300

取值范围

30到86400

参数单位

秒

参数含义

设置两次automatic WAL checkpoints的时间间隔。增加本参数值会导致进行crash recovery的时间长度增大。本参数值仅能在postgresql.conf设置或者在server command line中设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

Real

默认值

0.5

取值范围

0到1

参数单位

参数含义

指定了checkpoint 完成的目标，即:checkpoint需要在checkpoint_timeout\* checkpoint_completion_target的时间长度内完成。本参数值仅能在postgresql.conf设置或者在server command line中设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

Integer

默认值

32，注意：linux平台下本参数默认值为32，Windows平台下本参数默认值为0

取值范围

0到256，如果BLCKSZ符号常量值不是8KB，请根据比例进行修改。

参数单位

8KB，若是指定参数值时不带单位，默认是BLCKSZ bytes，在不修改BLCKSZ符号常量值的情况下，该符号常量值为8KB。

参数含义

每当在执行检查点时写入的数据量超过本参数值时，会尝试强制操作系统向底层存储发出这些写入操作。这样会限制kernel page cache中dirty data的总量，减少了在checkpoint的末尾发出fsync命令时，或者当操作系统在后台以更大的批写入数据时，PostgreSQL暂停的可能性。这通常会大大减少事务延迟，但也有一些情况，特别是在工作负载大于shared_buffers，但小于操作系统page cache的情况下，性能可能会降低。本参数值仅可以在postgresql.conf中设置或者在server command line进行设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

30

取值范围

0到2147483647，0会禁用warning。

参数单位

秒。若是指定本参数值不带单位，默认是秒

参数含义

如果由于填充WAL段文件而导致的检查点发生的时间间隔比本参数值更小（这表明应该加大max_wal_size配置参数值），则向服务器日志写入一条消息。当checkpoint_timeout参数值小于checkpoint_warning参数值时，warning不会产生。本参数值仅可以在postgresql.conf中设置或者在server command line进行设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

Integer

默认值

1024

取值范围

2到2147483647

参数单位

MB

参数含义

触发automatic checkpoints的最大wal 大小。这是软限制，wal size可以在如下情况下超过本参数值的限制：重负载，失败的archive_command命令，以及高的wal_keep_size参数值设置。增加本参数值会导致进行crash recovery的时间长度增大。本参数值仅能在postgresql.conf设置或者在server command line中设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

Integer

默认值

80

取值范围

2到2147483647

参数单位

MB

参数含义

只要WAL Disk的使用低于本参数值，旧的wal文件总是在checkpoint发生时被循环使用，而不是删除wal文件。这可以用来确保保留足够的WAL空间来处理WAL使用中的峰值，例如在运行大型批处理作业时。此参数只能在postgresql.conf文件文件或在server command line上。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

bool

默认值

on

取值范围

on和off

参数单位

参数含义

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

integer

默认值

12

取值范围

2到2147483647

参数单位

参数含义

本参数是启用geqo的阈值，即:当from之后的关系数量至少有本参数值指定的个数时，才启用geqo。注意一个FULL OUTER JOIN只被计为一个FROM项。对于简单的SQL语句，通常最好使用常规的穷举搜索planner，但是对于具有许多表的查询，穷举搜索花费的时间太长，通常比执行次优计划的代价要长，因此，本阈值是管理geqo的一种方法。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

Integer

默认值

5

取值范围

1到10

参数单位

参数含义

控制GEQO中计划时间和查询计划质量之间的权衡。此变量必须是1到10之间的整数。默认值为5。较大的值会增加生成查询计划所花费的时间，但也会增加选择高效查询计划的可能性。本参数实际上并不直接做任何事情；它只用于计算影响geqo行为的其他变量的默认值。如果愿意，可以手动设置其他参数。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

Integer

默认值

0，0表示PostgreSQL会根据SQL语句中表的数量以及geqo_effort参数值选择一个合适的值。

取值范围

0到2147483647

参数单位

参数含义

控制GEQO使用的pool size，即:遗传群体中的个体数，至少是2，有用的值通常是100到1000. 参数值为0表示PostgreSQL会根据SQL语句中表的数量以及geqo_effort参数值选择一个合适的值。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

Integer

默认值

0

取值范围

0到2147483647

参数单位

参数含义

控制GEQO使用的generations，即算法的迭代次数。它必须至少是一个，并且有用的值通常是100到1000。如果设置为零（默认设置），则PostgreSQL会根据geqo_pool_size选择合适的值。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

real

默认值

2

取值范围

1.5到2

参数单位

参数含义

控制GEQO使用的选择偏差。选择偏差是population内部的选择压力

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

real

默认值

0

取值范围

0到1

参数单位

参数含义

控制GEQO用于通过连接顺序搜索空间选择随机路径的随机数生成器的初始值，更改该值将更改所探索的连接路径集。并可能导致找到更好或更差的最佳路径

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

string

默认值

空串

取值范围

immediate

参数单位

参数含义

此参数指定恢复应在达到一致状态后尽快结束，即尽早结束。从联机备份还原时，这意味着在备份结束的时间点结束恢复。

是否可session级修改

否

修改后何时生效

本参数不支持修改。

数据类型

string

默认值

空串

取值范围

参数单位

参数含义

此参数指定将继续恢复(recovery)到的命名还原点,该还原点由函数pg_create_restore_point()创建。

是否可session级修改

否

修改后何时生效

重启PG Instance生效

数据类型

string

默认值

空串

取值范围

参数单位

参数含义

此参数指定将继续恢复(recovery)到的time stamp，精确的停止点受到recovery_target_inclusive配置参数影响。此参数的值是一个时间戳，其格式与timestamp with time zone数据类型所接受的格式相同，只是您不能使用时区缩写（除非在配置文件的前面设置了timezone_abbreviations变量）。首选样式是使用UTC的数字偏移量，或者您可以编写完整的时区名称，例如，Europe/Helsinki，而不是EEST

是否可session级修改

否

修改后何时生效

重启PG Instance生效

数据类型

string

默认值

取值范围

参数单位

参数含义

此参数指定将继续恢复(recovery)到的trasaction ID。请记住，虽然事务ID在事务开始时按顺序分配，但事务可以按不同的数字顺序完成。要恢复的事务是在指定事务之前提交的事务（也可以选择包括指定事务），精确的停止点受到recovery_target_inclusive配置参数影响。

是否可session级修改

否

修改后何时生效

重启PG Instance生效

数据类型

string

默认值

空串

取值范围

参数单位

参数含义

此参数指定将继续恢复(recovery)到的LSN，精确的停止点受到recovery_target_inclusive配置参数影响。本参数使用系统数据类型pg_lsn解析。

是否可session级修改

否

修改后何时生效

重启PG Instance生效

数据类型

bool

默认值

on

取值范围

on和off

参数单位

参数含义

当本参数设置为on时指定到达指定的recovery target之后停止当本参数设置为off时指定到达指定的recovery target之前停止本参数与如下参数配合使用：recovery_target_lsn、recovery_target_time、recovery_target_xid。本参数控制含有精确recovery target(恢复目标)的LSN、commit time、或者trasaction id是否被包括恢复(recovery)之内。

是否可session级修改

否

修改后何时生效

重启PG Instance生效

数据类型

string

默认值

latest

取值范围

参数单位

参数含义

指定recovery进入一个特定的timeline，本参数值可以是一个数字的timeline id或者一个特定的值，值current的含义：recover到做base backup时的那个timeline；值latest表示recover到在archive 中找到的最新的timeline，值latest适用于standby server。您通常只需要在复杂的重新恢复情况下设置本参数，在这种情况下，您需要返回到在时间点恢复之后达到的状态。

是否可session级修改

否

修改后何时生效

重启PG Instance生效

数据类型

enum

默认值

pause

取值范围

pause,promote,shutdown

参数单位

参数含义

指定了一旦达到recovery target，PostgreSQL该采取的操作。默认值pause表示恢复暂停(pause)，值promote表示恢复过程完成并且PostgreSQL将会启动以接受外部连接，值shutdown表示在达到recovery target之后会stop PostgreSQL。pause值的预期用途是允许对数据库执行查询，以检查此恢复目标是否是最理想的恢复点,pg_wal_replay_resume()函数表示paused state resumed，这意味着恢复走到了终点。若是recovery target不是期望的那个stopping point，那么请关闭PostgreSQL，改变recovery target到更为之后的一个target，然后重启recovery即可。

是否可session级修改

否

修改后何时生效

重启PG Instance生效

数据类型

integer

默认值

100

取值范围

1到10000

参数单位

参数含义

为没有通过ALTER TABLE SET STATISTICS设置column-specific target的表列设置默认统计目标。较大的本参数值会增加analyze的时间，但也会提升planner估计的质量。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

enum

默认值

partition

取值范围

partition,on,off on表示检查所有表的约束 off表示不检查约束partition表示仅仅对继承的子表以及union all子查询检查约束。

参数单位

参数含义

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

real

默认值

0.1

取值范围

0到1

参数单位

参数含义

设置planner’s估计，本参数设置较少的值时，会使planner倾向于对cursors使用"fast start" plan，这会快速的检索前几行，而获取所有行可能需要很长时间。较大的值更强调总的估计时间。在最大设置为1.0时，游标的规划与常规查询完全相同，只考虑总的估计时间，而不考虑第一行的交付时间。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

integer

默认值

8

取值范围

1到2147483647

参数单位

参数含义

如果生成的FROM列表包含的项目不超过本参数值，那么planner将会把子查询合并到上面的查询中。较小的值会减少计划时间，但可能会产生较差的查询计划。设置本参数值为geqo_threshold参数值或者更大可能会触发GEQO Planner的使用，进而导致非优化的执行计划。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

bool

默认值

on

取值范围

on和off

参数单位

参数含义

确定jit编译是否被PostgreSQL使用。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

integer

默认值

8

取值范围

1到2147483647

参数单位

参数含义

每当生成的items列表不超过本参数值时,planner就会将explicit join结构（FULL JOINs除外）重写为FROM items列表。较小的值会减少计划时间，但可能会产生较差的查询计划.默认情况下，此参数值设置为与from_collapse_limit参数值相同，这适用于大多数用途。将其设置为1可防止explicit join的任何重新排序。因此，查询中指定的显式连接顺序将是连接关系的实际顺序。因为查询规划器并不总是选择最佳的连接顺序，所以高级用户可以选择将此参数值临时设置为1，然后显式指定所需的连接顺序。设置本参数值为geqo_threshold参数值或者更大可能会触发GEQO Planner的使用，进而导致非优化的执行计划。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

bool

默认值

on

取值范围

on和off

参数单位

参数含义

允许leader进程在Gather和Gather Merge node下执行查询计划，而不是等待worker进程。将此值设置为off可降低worker进程被阻塞的可能性，因为leader进程读取元组的速度不够快，但需要leader进程等待工作进程启动，然后才能生成第一个元组。Leader进程能够帮助或阻碍性能的程度取决于计划类型、worker数量和查询持续时间。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

enum

默认值

off

取值范围

off,on,regress off表示仅仅当预期能提升性能时，才使用parallel mode on表示对被视为safe的查询语句强制使用并行查询。regress表示除了有本参数值设置为"on"的相同的所有效果之外，还有一些旨在促进自动回归测试的附加效果

参数单位

参数含义

是否使用parallel query功能。更具体地说，将此值设置为on将在任何查询计划的顶部添加一个Gather节点，这看起来是安全的，因此查询在并行worker进程中运行，即使并行worker进程不可用或无法使用，也将禁止在并行查询上下文中禁止的操作（如启动子事务），除非planner认为这将导致查询失败，如果设置此选项时出现故障或意外结果，则查询使用的某些函数可能需要标记为PARALLEL UNSAFE（或者，可能是PARALLEL RESTRICTED）通常，来自并行worker进程的消息包含一个context line，但是设置为regress会抑制该context line，以便输出与非并行执行中的输出相同。此外，通过此设置，添加到计划中的Gather nodes将隐藏在EXPLAIN的输出中，以便当本参数值设置为off时，输出与获得的结果相匹配。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

enum

默认值

auto

取值范围

auto,force_generic_plan,force_custom_plan

参数单位

参数含义

可以使用自定义或generic的plan执行prepared statements（explicitly prepared或implicitly generated，例如通过PL/pgSQL），针对每一次的执行，自定义plan使用特定的一组参数值被重新生成，generic plans不依赖本plan_cache_mode参数值，可以被多次的执行重复使用。此外，使用generic plans会节省 planning time，但是，如果理想的plan强烈依靠本参数，那么，generic plan可能效率低下。这些选项之间的选择通常是自动进行的，但它可以被plan_cache_mode配置参数覆盖。在执行缓存的计划时，而不是在准备计划时，会考虑本参数值

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

bool

默认值

on，本参数值为on时表示允许输入包括NULL的数组值

取值范围

on和off

参数单位

参数含义

本参数控制数组输入解析器是否将未加引号的NULL识别为指定NULL数组元素。8.2版本之前的PostgreSQL不支持数组中的null值，因此将null视为使用字符串值"null"指定普通数组元素。为了向后兼容需要旧行为的应用程序，可以关闭此参数。请注意，即使本参数值是off，也可以创建包含NULL的数组值

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

enum

默认值

safe_encoding

取值范围

safe_encoding,on,off on表示始终允许\' off表示始终拒绝'safe_encoding表示仅当客户端编码不允许在多字节字符中使用ASCII\时才允许.

参数单位

参数含义

本参数用于设置字符串的引用符是否是'符号。SQL标准中是'',而PostgreSQL历史上也接受了'符号，但是，使用'会带来安全风险，这是因为，在一些客户端字符集编码中，存在多字节字符，其中最后一个字节在数字上等同于ASCII \.如果客户端没有正确的转义，那么SQL注入攻击是可能的。这种风险可以通过使PostgreSQL数据库拒绝引用符被backslash反斜杠转义的查询来防止。请注意，在标准一致性字符串文本中，无论如何，\仅仅表示\。此参数仅影响对非标准一致性文本的处理，包括转义字符串语法（E'…'）

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

bool

默认值

on

取值范围

on和off

参数单位

参数含义

当设置为on时，表示当\出现在一个普通的字符串('…'这样的)中并且standard_conforming_strings参数值为off时，一个warning会发出。希望使用反斜杠作为转义的应用程序应该修改为使用转义字符串语法（E'…'）. 因为根据SQL标准，普通字符串的默认行为现在是将反斜杠视为普通字符. 可以启用本参数来帮助定位需要更改的代码

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

bool

默认值

off

取值范围

参数单位

参数含义

对large object，为权限检查启用面向backward的兼容性模式。在PostgreSQL9.0之前，large object并不具有访问权限，因此，large object总是能被所有的user进行读和写。设置本参数值为on将会禁用新权限的检查，这会与PostgreSQL9.0之前的版本保持兼容。

是否可session级修改

是，仅限于superuser进行修改

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

bool

默认值

off

取值范围

on和off

参数单位

参数含义

启用此选项后，解析器将对自PostgreSQL 9.4以来由于运算符优先级的更改而可能已更改含义的任何构造发出警告。对于审核应用程序以查看优先级更改是否破坏了任何内容非常有用；但这并不意味着在生产环境中保持打开状态，因为它将警告某些完全有效、符合标准的SQL代码

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

bool

默认值

off

取值范围

on和off

参数单位

参数含义

SELECT company.id,+

company.name,

company.age

FROM company;
postgres=# set quote_all_identifiers=on; SET postgres=# select pg_get_viewdef('company_view'); -[RECORD 1]--+------------------------ pg_get_viewdef

SELECT "company"."id",+

"company"."name",

"company"."age"

FROM "company";
postgres=#

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

bool

默认值

on

取值范围

on和off

参数单位

参数含义

本参数控制普通字符串文本（'…'）是否按SQL标准中的指定按字面含义处理反斜杠.从PostgreSQL9.1开始，默认值为on。此参数的存在也可以被视为表示支持转义字符串语法（E'…'）如果应用程序希望反斜杠被视为转义字符，则应使用转义字符串语法

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

bool

默认值

on

取值范围

on和off

参数单位

参数含义

这允许对大表的顺序扫描彼此同步，以便并发扫描在大约相同的时间读取相同的块，从而共享I/O工作负载。启用本参数后，扫描可能从表的中间开始，然后"环绕"结尾以覆盖所有行，以便与正在进行的扫描活动同步。这可能导致没有ORDERBY子句的查询返回的行顺序发生不可预知的更改。将此参数设置为off可确保与PostgreSQL 8.3之前的行为，即顺序扫描始终从表的开头开始

是否可session级修改

是

修改后何时生效

Session级别修改立即生效，其他级别修改reload生效

数据类型

string

默认值

localhost

取值范围

参数单位

参数含义

设置数据库服务器监听的hostname或者IP地址，监听多个hostname或者IP地址时，请用逗号隔开。 \*号表示监听所有可用的IP地址， 0:0:0:0监听代表所有IPV4的地址， ::代表监听所有IPV6的地址。当本参数值为空时，PostgreSQL不会监听任何的IP，此时，只有Unix-domain sockets才可以用于连接到数据库中。本参数控制哪些IP地址上接受连接尝试，这可以帮助防止在不安全的IP地址上重复出现恶意连接请求。该参数只能在PostgreSQL启动时设置。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

integer

默认值

5432

取值范围

1到65535

参数单位

参数含义

PostgreSQL监听的TCP端口。请注意，PostgreSQL监听的所有IP地址都使用相同的端口号，本参数只能在PostgreSQL启动时设置。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

integer

默认值

100

取值范围

1到262143

参数单位

参数含义

本参数值指定了PostgreSQL数据库的最大连接数。本参数只能在PostgreSQL启动时设置。在流复制备库上，必须将本参数值设置为与主库相同或者比主库参数值大,否则，后备服务器将不允许查询操作。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

integer

默认值

3

取值范围

0到262143

参数单位

参数含义

为superusers保留的connection "slots"的数量，当PostgreSQL的活跃的并发连接的数量等于max_connections参数值减去superuser_reserved_connections参数值之后，仅仅可以面向superuser建立新的连接，并且，replication connection也是建立不了的。本参数只能在PostgreSQL启动时设置。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

string

默认值

在Linux中默认值为/tmp；在Windows中默认值为空

取值范围

参数单位

参数含义

本参数指定了PostgreSQL监听客户端连接的Unix-domain socket(s)目录，多个目录可以用逗号隔开，两个目录之间的空格会被忽略，如果你想在目录名中包括逗号或者空格，请使用双引号引起来。本参数值为空时表示不监听任何的Unix-domain socket(s)目录，这意味着只有TCP/IP sockets可以被用来连接到PostgreSQL中。本参数只能在PostgreSQL启动时设置。在本参数值指定的目录下，会有名为s.PGSQL.nnnn的socket file，nnnn是PostgreSQL使用的端口号，在该目录下，还有一个名为.s.PGSQL.nnnn.lock的文件。这两个文件请不要手工删除。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

string

默认值

空字符串，空字符串表示使用启动PostgreSQL 的user的默认组。

取值范围

参数单位

参数含义

设置Unix-domain socket(s).的owning group(请注意：socket的owning user总是启动PostgreSQL的user)。本参数与unix_socket_permissions结合使用可以将其作为Unix-domain connections的额外访问控制机制。本参数只能在PostgreSQL启动时设置。本参数不支持在Windows上使用，在Windows上，本参数取任何值都会被忽略。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

integer

默认值

0777，0777表示任何人都可以连接

取值范围

0到511

参数单位

参数含义

本参数用于设置Unix-domain socket(s)的访问权限。Unix-domain socket使用通常的Unix文件系统权限集。参数值预计是被chmod和umask系统调用接受的数字模式。（要使用惯用的八进制格式，数字必须以0（零）开头。）合理的参数值是0770（仅用户和组，另请参见unix_socket_group）和0700（仅用户）。请注意，对于Unix-domain socket，仅写许可权是重要的，因此设置或撤消读或执行许可权没有意义。本参数只能在PostgreSQL启动时设置。在完全忽略socket permissions的操作系统上（特别是自solaris10起的Solaris），此参数是不相关的。在此类操作系统上，可以通过将unix目录指向一个搜索权限仅限于所需访问用户的目录来实现类似的效果。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

boolean

默认值

off

取值范围

off和on

参数单位

参数含义

本参数控制是否通过Bonjour机制通告PostgreSQL的存在。本参数只能在PostgreSQL启动时设置。

是否可session级修改

否

修改后何时生效

重启PG instance生效。

数据类型

string

默认值

空字符串。空字符串表示使用计算机名

取值范围

参数单位

参数含义

本参数用于设置Bonjour service name。当PostgreSQL软件没有编译Bonjour support时，本参数会被忽略。本参数只能在PostgreSQL启动时设置。

是否可session级修改

否

修改后何时生效

重启PG instance生效。

数据类型

integer

默认值

1

取值范围

0到1000，0表示禁止发布异步I/O请求

参数单位

参数含义

有效利用disk子系统的并发disk io的数量。目前，本参数仅仅影响bitmap heap scans。对于HDD(机械硬盘)，本参数的起始值应该是PostgreSQL database用到的、组成raid 0 条带或者raid 1镜像的单独 disk drive的个数。但是，如果PostgreSQL数据库经常忙于并发会话中发出的多个查询，则较低的值可能足以使磁盘阵列保持繁忙。高于使磁盘保持忙碌的本参数值只会导致额外的CPU开销，固态盘(SSD)以及其他基于内存的存储可以经常处理很多并发请求，因此，此时最佳的值可能是几百。异步IO请求取决于一个有效的posix_fadvise函数，该函数在有些操作系统上是缺少的。在该函数缺少时，设置本参数为非零值会导致错误发生。在有些操作系统上(比如Solaris),本函数存在但是并没有实际的执行任何操作。在受到支持的操作系统上，本参数值的默认值为1，否则为零。本参数值可以被tablespace级别的同名参数值所覆盖。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效非session级修改reload生效

数据类型

integer

默认值

10

取值范围

0到1000

参数单位

参数含义

本参数类似于effective_io_concurrency参数，但本参数用于代表许多客户端会话执行的维护工作。在受到支持的操作系统上，本参数值的默认值为10，否则为零。本参数值可以被tablespace级别的同名参数值所覆盖。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效非session级修改reload生效

数据类型

integer

默认值

8

取值范围

0到262143

参数单位

参数含义

本参数值指定了PostgreSQL所能支持的并发worker进程的最大数量。本参数值仅能在PostgreSQL启动时设置。当运行在standby server环境中时，在standby server上的本参数值必须大于或者等于在master server上的本参数值。否则，query是不能运行在standby server上。当改变本参数值时，请考虑调整max_parallel_workers,参数，max_parallel_maintenance_workers参数，max_parallel_workers_per_gather参数

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

integer

默认值

2

取值范围

0到1024，0表示禁用parallel query execution

参数单位

参数含义

本参数指定了可以被单个Gather或者Gather Merge Node启动的worker进程的最大数量。Parallel Workers进程从由max_worker_processes配置参数建立的进程池中获取，受限于max_parallel_workers配置参数。请注意，请求的workers的数量在运行时并不一定实际可用，如果这个情况发生，执行计划会以少于期望个数的workers去运行，这可能是低效的。请注意，parallel queries可能比非parallel queries消耗更多的资源，因为每个工作进程是一个完全独立的进程，其对系统的影响与附加用户会话大致相同。在为此设置选择值时，以及在配置控制资源利用率的其他设置（如work_mem）时，都应考虑到这一点。诸如work_mem之类的资源限制单独应用于每个worker，这意味着所有进程的总利用率可能比任何单个进程的正常利用率高得多。例如，一个使用4个worker的并行查询可能会使用多达5倍的CPU时间、内存、I/O带宽。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效非session级修改reload生效

数据类型

integer

默认值

2

取值范围

0到1024，0表示禁用由实用命令使用的parallel workers

参数单位

参数含义

可以被单个实用命令启动的parallel worker的最大数量。当前，支持parallel workers的并行实用命令有如下几种： create index 建立B-Tree时； vacuum 不带full选项时； Parallel Workers进程从由max_worker_processes配置参数建立的进程池中获取，受限于max_parallel_workers配置参数。请注意，请求的workers的数量在运行时并不一定实际可用，如果这个情况发生，执行计划会以少于期望个数的workers去运行，这可能是低效的。注意，并行实用程序命令不应该比等效的非并行操作消耗更多的内存，这种策略不同于并行查询，在并行查询中资源限制通常适用于每个worker进程。并行实用命令将资源限制maintenance_work_mem视为应用于整个实用命令的限制，而不考虑并行工作进程的数量。然而，并行实用命令仍然可能消耗更多的CPU资源和I/O带宽。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效非session级修改reload生效

数据类型

integer

默认值

8

取值范围

0到1024

参数单位

参数含义

本参数值指定了PostgreSQL支持的parallel操作的worker的最大数量。当增加或者减少本参数值时，请考虑同时调整max_parallel_maintenance_workers 配置参数和 max_parallel_workers_per_gather配置参数。请注意：当本参数值高于max_worker_processes参数值时不会有任何作用。因为，因为parallel workers是从max_worker_processes配置参数所建立的工作进程池中获取的。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效非session级修改reload生效

数据类型

integer

默认值

0，0表示禁用强制writeback

取值范围

0到256

参数单位

8KB

参数含义

每当单个backend进程写入的数据超过本参数值时，尝试强制操作系统向底层存储发出这些写入操作。这样做将限制内核page cache中脏数据的数量，减少在检查点结束时发出fsync时，或者当操作系统在后台以更大的批写入数据时暂停的可能性。这通常会大大减少事务延迟，但也有一些情况，特别是在工作负载大于共享缓冲区，但小于操作系统page cache的情况下，性能可能会降低。此参数可能在某些平台下无效。如果指定该值时没有单位，则将其作为块，即源码中的符号常量BLCKSZ个字节，通常为8KB。如果BLCKSZ不是8KB，则最大值与之成比例缩放。

是否可session级修改

是

修改后何时生效

Session级别修改立即生效非session级修改reload生效

数据类型

intger

默认值

-1，-1代表禁用本特性，表示snapshot age 是无限制的。

取值范围

-1到86400

参数单位

分钟

参数含义

设置在使用snapshot时可以使用查询快照而不会出现"snapshot too old"错误的最短时间。处于dead状态的且超过本参数值的数据可以被vacuum掉。这有助于防止snapshot长期使用时出现表膨胀。为了防止由于清除快照可见的数据而产生不正确的结果，当快照早于本参数值并且快照用于读取自创建快照以来已修改的页面时，将生成一个错误。对生产环境有用的值可能从几个小时到几天不等。只允许使用较小的值（如0或1min），因为它们有时可能对测试有用。虽然允许高达60d的设置，但请注意，在许多工作负载中，在更短的时间内可能会出现极端膨胀或事务ID环绕(transaction ID wraparound)。启用本特性后，relation末尾释放的空间将无法释放给操作系统，因为这可能会删除检测"snapshot too old"条件所需的信息。分配给relation的所有空间都与该relation保持关联，以便仅在该relation中重用，除非显式释放（例如，使用VACUUM FULL）。此参数并不试图保证在任何特定情况下都会生成错误。事实上，如果正确的结果可以从一个已经物化的结果集中生成，则即使引用表中的底层行已被vacuum，也不会生成错误。某些表不能安全地提前vacuum，因此不受此设置的影响，例如系统目录(system catalogs)。对于这样的表，此设置既不会减少膨胀，也不会在扫描时产生"snapshot too old"错误的可能性。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

string

默认值

空字符串

取值范围

参数单位

参数含义

本参数为备库参数，本参数在sending-server端会被忽略。本参数值指定了连接到sending server的连接字符串(连接信息）.在本连接字符串中缺少的option，PostgreSQL会到环境变量中取寻找。若是环境变量中也没有，那么就用默认值。连接字符串应该指定如下信息： Sending Server的主机名或者IP地址、 Sending Server的端口号（若是跟standby server端口号不同） Username(该用户在sending-server端有合适的权限) Password：请注意，密码可以在primary_conninfo中提供，也可以在standby server上的~/.pgpass文件中提供（此时，是用replication作为database name）。请不要在primary_conninfo中指定database的名字本参数仅能在postgresql.conf文件或者server command line中设置。当在wal receiver process正在运行的情况下修改本参数值，wal receiver process会被发信号通知关闭然后再以新参数值去启动，除非primary_conninfo配置参数为空字符串。当PostgreSQL没有处于standby mode的情况下，本参数无效。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

string

默认值

空字符串

取值范围

参数单位

参数含义

本参数为备库参数，本参数在sending-server端会被忽略。本参数指定了当要连接到sending-server端时，要使用的sending-server端的已经存在的replication slot，用来控制sending-server端的wal removal。本参数仅能在postgresql.conf文件或者server command line中设置。当在wal receiver process正在运行的情况下修改本参数值，wal receiver process会被发信号通知关闭然后再以新参数值去启动，本参数在如下情况下没有作用：PostgreSQL没有处于standby mode或者primary_conninfo参数值没有设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

string

默认值

空字符串

取值范围

参数单位

参数含义

本参数为备库参数，本参数在sending-server端会被忽略。本参数值指定了一个trigger file，该文件用于standby server结束recovery状态进行角色提升。本参数值没有设置时，你可以使用pg_ctl promote或者使用函数pg_promote()进行角色提升。本参数仅能在postgresql.conf文件或者server command line中设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

bool

默认值

on

取值范围

on和off

参数单位

参数含义

本参数为备库参数，本参数在sending-server端会被忽略。本参数控制standby server是否允许运行只读查询语句。本参数仅能在server start时设置。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

integer

默认值

30000

取值范围

-1到2147483647，-1表示允许standby server一直在等待直到冲突的query执行完毕。

参数单位

毫秒

参数含义

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

30000

取值范围

-1到2147483647，-1表示允许standby server一直在等待直到冲突的query执行完毕。

参数单位

毫秒

参数含义

本参数为备库参数，本参数在sending-server端会被忽略。当hot standby在被启用的状态下，本参数决定了standby server在取消掉standby中运行的且与WAL日志应用有冲突的查询语句之前的等待时间。本参数适用于wal data通过流复制被接收的情况。当不指定单位时，本参数的单位是毫秒。本参数仅能在postgresql.conf文件或者server command line中设置。本参数值与查询语句在取消之前可以运行的最长时间不同。相反，本参数值是从主服务器接收到WAL数据后允许应用该数据的最长总时间，因此，如果一个查询导致了显著的延迟，那么在后备服务器再次赶上之前，后续冲突查询的容忍时间(宽限时间)将少得多

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

bool

默认值

off

取值范围

off和on

参数单位

参数含义

本参数为备库参数，本参数在sending-server端会被忽略。本参数用于指定当永久的复制槽没有配置(复制槽配置请见配置参数primary_slot_name)的情况下，wal receiver是否在远程PG Cluster上创建一个临时的复制槽。本参数仅能在postgresql.conf文件或者server command line中设置。当wal receiver进程正在运行的同时本参数被改变时，wal receiver进程会关闭并重启以读取到新值。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

10

取值范围

0到2147483，0表示完全禁止状态更新。

参数单位

秒

参数含义

本参数为备库参数，本参数在sending-server端会被忽略。本参数指定了备库上的wal receiver 进程向 primary库或者sending-server库发送复制进度(replication progress)的最短时间频率。备库将报告它写到的wal的位置，它flush 到disk的位置以及它应用wal的位置。本参数值是两次报告之间的最大时间间隔。每次写入(write)或刷新(flush)位置更改时都会发送更新，或者至少与本参数指定的频率相同。因此，应用的位置可能稍微落后于真实位置。本参数仅能在postgresql.conf文件或者server command line中设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

bool

默认值

off

取值范围

off和on

参数单位

参数含义

本参数为备库参数，本参数在sending-server端会被忽略。是否允许一个hot standby的备库发送关于正在备库执行的查询的feedback给primary库或者upstream库。本参数值可以消除由于cleanup records导致的query cancels，但是会导致primary库上发生膨胀。feedback信息的发送频率不会超过配置参数wal_receiver_status_interval。当是级联复制环境时，feedback会通过upstream(即:中间节点)会最终到达primary库。Standby节点除了向upstream反馈信息外，没有其他用途。本参数不会覆盖primary端的配置参数old_snapshot_threshold的行为。Standby端上超过primary端age阈值的snapshot会变为invalid，这导致standby端上的查询被取消。这是因为配置参数old_snapshot_threshold的目的是在时间上对dead row导致膨胀提供绝对的限制，否则会因为standby的配置违反该限制。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

60000

取值范围

0到2147483647，0代表禁用本timeout检测机制。

参数单位

毫秒

参数含义

本参数为备库参数，本参数在sending-server端会被忽略。当本备端与sending-server端或者primary端的inactive状态超过本参数值时，终止掉复制连接。本参数对receiving standby server检测primary node crash或者网络故障很有用。本参数仅能在postgresql.conf文件或者server command line中设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

5000

取值范围

1到2147483647

参数单位

毫秒

参数含义

本参数为备库参数，本参数在sending-server端会被忽略。本参数控制standby server遇到从所有源头(streaming replication、本地pg_wal目录、WAL Archive位置)获取wal而获取不到时的等待时间。本参数对处于in recovery的节点需要控制等待新的wal data可用的时间很有用。比如，在archive recovery中，通过降低本参数值，在检测一个新wal log file时，可以使recovery更快响应。在一个wal file产生很少的PostgreSQL中，增加本参数值会减少访问wal archive的请求次数。这在那些基础设施的访问次数会被考虑在内的云环境中非常有用。本参数仅能在postgresql.conf文件或者server command line中设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

0，0代表无延迟。

取值范围

0到2147483647

参数单位

毫秒

参数含义

本参数为备库参数，本参数在sending-server端会被忽略。默认情况下，standby server会及时的restore 来自于sending server端的WAL 记录。数据的延迟copy可能很有用，它提供了纠正数据丢失错误的机会。本参数值指定了允许你指定延迟recovery的时间长度。比如，你设置本参数值为5分钟，那么只有当standby端的系统时间比master端报告的提交时间至少晚5分钟时，standby端才会重放每个事物的提交。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

real

默认值

1

取值范围

0到1.79769e+308

参数单位

参数含义

本参数设置了顺序读取磁盘上的page的成本。在table以及index上的表空间级别的同名本参数可以覆盖配置参数中的该参数值。增大本参数值会使索引扫描看起来相对更昂贵

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

real

默认值

4

取值范围

0到1.79769e+308

参数单位

参数含义

本参数设置了非顺序读取磁盘上的page的成本。在table以及index上的表空间级别的同名本参数可以覆盖配置参数中的该参数值。相对于seq_page_cost减少本参数值会使PostgreSQL更倾向于使用索引扫描。随机访问机械硬盘要比四次顺序访问还要昂贵。但是，使用较低的默认值(4.0)，因为大多数对磁盘的随机访问(如索引读取)都假定在cache中。默认值可以认为是将随机访问模型比顺序访问慢40倍，同时，期望90%的随机读取都是在cache中。如果您认为90%的缓存比率对于您的工作负载来说是一个不正确的假设，那么你可以增加本参数值以反映随机存储读取的真实成本。相应的，如果你的数据可能完全在cache中，比如在database大小小于服务器内存，减少本参数值是合适的。那些相对于顺序读具有低随机读成本的存储（比如固态驱动器），也可以使用较低本参数值（比如1.1）

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

real

默认值

0.01

取值范围

0到1.79769e+308

参数单位

参数含义

本参数值设置在执行一个SQL语句时planner预计的处理每行数据的成本

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

real

默认值

0.005

取值范围

0到1.79769e+308

参数单位

参数含义

本参数用于设置在索引扫描期间planner预计的处理每个index entry的成本。

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

real

默认值

0.0025

取值范围

0到1.79769e+308

参数单位

参数含义

本参数值设置在执行一个SQL语句时planner预计的处理执行的每个operator或者function的成本。

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

real

默认值

1000

取值范围

0到1.79769e+308

参数单位

参数含义

本参数值设置planner预估的启动parallel worker processes的成本。

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

real

默认值

0.1

取值范围

0到1.79769e+308

参数单位

参数含义

本参数值设置了从一个parallel worker进程将一个tuple传输到另外一个parallel worker进程的成本。

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

integer

默认值

1024，默认情况下是8MB

取值范围

0到715827882

参数单位

8KB

参数含义

本参数设置了考虑使用parallel scan的table的数据(data)的最小大小，对于并行顺序扫描，table的数据(data)的最小大小总是等于table的大小。但是当index被用到时，table的数据(data)的最小大小通常会笑。如果本参数不带单位，取的是源码中符号常量BLCKSZ的值，通常为8KB。

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

integer

默认值

64，默认情况下是512KB

取值范围

0到715827882

参数单位

8KB

参数含义

本参数设置了考虑使用parallel scan的index的数据(data)的最小大小，请注意：一个并行索引扫通常不会扫过整个index。本参数是planner认为扫描实际会涉及的页数，本参数也用来决定一个特定的索引是否可以参与并行vacuum。如果本参数不带单位，取的是源码中符号常量BLCKSZ的值。

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

integer

默认值

524288

取值范围

1到2147483647

参数单位

8KB

参数含义

本参数设置了planner对单个SQL语句可用的disk cache的有效大小。这被纳入使用索引的成本估算中。值越大，使用索引扫描的可能性越大；值越小，使用顺序扫描的可能性越大。设置本参数时，应该同时考虑PostgreSQL的shared buffers和kernel的page cache用于PostgreSQL数据文件的部分，虽然这两个位置都可能存在一些数据。另外，还要考虑在不同表上预计的并发SQL语句数量，因为他们必须共享可用空间。本参数不影响PostgreSQL分配的shared buffers大小，也不会保留kernel的page cache。它仅用于估算目的。系统也不坚定在两次查询之间数据扔保留在磁盘cache中。如果本参数不带单位，取的是源码中符号常量BLCKSZ的值。通常为8KB。如果BLCKSZ不是8KB，则默认值按照定比例缩放。

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

real

默认值

100000

取值范围

-1到1.79769e+308。-1表示禁用JIT编译

参数单位

参数含义

当SQL语句的查询成本高于本参数值时，JIT编译会被激活，若是JIT编译被enable的情况下。执行JIT会消耗planning time但是可以加速查询执行。

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

real

默认值

500000

取值范围

-1到1.79769e+308，-1表示禁用inline

参数单位

参数含义

当SQL语句的查询成本高于本参数值时，JIT编译会尝试inline functions and operators。Inlining会增加planning time，但是会提升执行速度。将本参数值设置为低于jit_above_cost是没有意义的。

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

real

默认值

500000

取值范围

-1到1.79769e+308，-1表示禁用expensive optimizations

参数单位

参数含义

当SQL语句的查询成本高于本参数值时，JIT编译会尝试进行expensive optimizations。这种优化会增加planning time，但是会提升执行速度。将本参数值设置为低于jit_above_cost是没有意义的，将本参数值设置为高于jit_inline_above_cost也是没有益处的。

是否可session级修改

是

修改后何时生效

Session修改立即生效；其他修改Reload即可生效

数据类型

bool

默认值

on

取值范围

on和off

参数单位

参数含义

控制PostgreSQL是否允许autovacuum launcher daemon.autovacuum进程能正常工作的前提条件是配置参数track_counts设置为启用。本参数仅能在postgresql.conf文件或者server command line中设置。本参数可以在表级设置，在表级设置的优先级高于配置参数中的优先级。即使本参数被禁用，若是需要防止事务id wraparound，PostgreSQL会启动autovacuum进程。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

0，0表示记录所有autovacuum操作到PostgreSQL运行日志中

取值范围

-1到2147483647，-1表示禁止autovacuum进程执行信息打印到PostgreSQL运行日志中。

参数单位

毫秒

参数含义

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

3

取值范围

1到262143

参数单位

参数含义

本参数设置了同时可以运行的autovacuum worker进程的最大个数。本参数仅仅可以在PostgreSQL启动时设置。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

integer

默认值

60

取值范围

1·到2147483

参数单位

秒

参数含义

本参数指定了两次autovacuum进程运行的最小时间间隔。在每次autovacuum进程运行时，autovacuum守护进程检查数据库并针对需要的表发出vacuum和analyze命令。本参数仅能在postgresql.conf文件或者server command line中设置。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

50

取值范围

0到2147483647

参数单位

参数含义

本参数用于设置作为vacuum操作候选表的条件，即:更新或者删除掉多少条记录可以被作为vacuum操作的候选表。本参数仅能在postgresql.conf文件或者server command line中设置。本参数可以在表级设置，在表级设置的优先级高于配置参数中的优先级。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

1000

取值范围

-1到2147483647，-1表示即使有本参数值数量的insert记录，autovacuum守护进程也不会针对该表触发vacuum操作。

参数单位

参数含义

本参数用于设置作为vacuum操作候选表的条件，即:插入多少条记录可以触发针对该表的vacuum。本参数仅能在postgresql.conf文件或者server command line中设置。本参数可以在表级设置，在表级设置的优先级高于配置参数中的优先级。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

50

取值范围

0到2147483647

参数单位

参数含义

本参数用于设置作为analyze操作候选表的条件，即:插入、更新、删除多少条记录可以触发针对该表的analyze。本参数仅能在postgresql.conf文件或者server command line中设置。本参数可以在表级设置，在表级设置的优先级高于配置参数中的优先级。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

real

默认值

0.2，0.2表示表大小的20%

取值范围

0到100

参数单位

参数含义

本参数设置了表大小的一个比率，当决定一个表是否触发vacuum操作时，该比率会被配置参数autovacuum_vacuum_threshold考虑在内。本参数仅能在postgresql.conf文件或者server command line中设置。本参数可以在表级设置，在表级设置的优先级高于配置参数中的优先级。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

real

默认值

0.2，0.2表示表大小的20%

取值范围

0到100

参数单位

参数含义

本参数设置了表大小的一个比率，当决定一个表是否触发vacuum操作时，该比率会被配置参数autovacuum_vacuum_insert_threshold考虑在内。本参数仅能在postgresql.conf文件或者server command line中设置。本参数可以在表级设置，在表级设置的优先级高于配置参数中的优先级。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

real

默认值

0.1

取值范围

0到100

参数单位

参数含义

本参数设置了表大小的一个比率，当决定一个表是否触发vacuum操作时，该比率会被配置参数autovacuum_analyze_threshold考虑在内。本参数仅能在postgresql.conf文件或者server command line中设置。本参数可以在表级设置，在表级设置的优先级高于配置参数中的优先级。

是否可session级修改

否

修改后何时生效

Reload即可生效

数据类型

integer

默认值

200000000

取值范围

100000到2000000000

参数单位

参数含义

指定表的pg_class.relfrozenxid字段在强制执行vacuum操作以防止事务ID wraparound之前可以达到的最大年龄，请注意，即使autovacuum进程被禁用，PostgreSQL也会为了防止wraparound而启动autovacuum进程。Vacuum还允许从pg_xact子目录中删除旧文件，这就是为什么默认值是相对较低的2亿个事务的原因。此参数只能在服务器启动时设置，但是可以通过更改表存储参数来减少单个表的设置值。

是否可session级修改

否

修改后何时生效

重启PG instance生效

数据类型

integer

默认值

400000000

取值范围

10000到2000000000