pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
文档 / 配置参数
配置参数（GUC）决定 PostgreSQL 运行时的行为：内存分配、预写式日志、检查点、查询规划、日志记录与自动清理都由它们控制，每一个都是 pg_settings 里的一行。本栏目收录 449 个参数，分属 16 个一级分类，覆盖 PostgreSQL 9.0 至 20，逐版本记下每个参数的默认值、生效方式、取值范围与说明变化。9.0 是本数据集的收录基线，不代表这些参数首次于 9.0 引入。
版本变动 未收录 存在 新增 属性或默认值变化 已移除
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
config_file |
字符串 | 重启生效 | 未设置 |
— | |
| 设置服务器主配置文件。 | 现存 | ||||
data_directory |
字符串 | 重启生效 | 未设置 |
— | |
| 设置服务器数据目录。 | 现存 | ||||
extension_destdir |
字符串 | 会话（超级用户） | 空字符串 |
— | |
| 设置加载扩展时要加在路径前的目录。（实测下游 pg_settings 简述。） | 于 18 移除 | ||||
external_pid_file |
字符串 | 重启生效 | 未设置 |
— | |
| 将 postmaster PID 写入指定文件。 | 现存 | ||||
hba_file |
字符串 | 重启生效 | 未设置 |
— | |
| 设置服务器的 HBA 配置文件。 | 现存 | ||||
hosts_file |
字符串 | 重启生效 | 未设置 |
— | |
| 设置服务器的 hosts 配置文件路径。 | 现存 | ||||
ident_file |
字符串 | 重启生效 | 未设置 |
— | |
| 设置服务器的 ident 配置文件。 | 现存 | ||||
| 连接设置 11 | |||||
bonjour |
布尔 | 重启生效 | off |
— | |
| 启用通过 Bonjour 广播服务器。 | 现存 | ||||
bonjour_name |
字符串 | 重启生效 | 空字符串 |
— | |
| 设置 Bonjour 服务名称。 | 现存 | ||||
listen_addresses |
字符串 | 重启生效 | localhost |
— | |
| 设置服务器监听的主机名或 IP 地址。 | 现存 | ||||
max_connections |
整数 | 重启生效 | 100 |
9.62 次 | |
| 设置数据库并发连接的最大数量。 | 现存 | ||||
port |
整数 | 重启生效 | 5432 |
— | |
| 设置服务器监听的 TCP 端口。 | 现存 | ||||
reserved_connections |
整数 | 重启生效 | 0 |
— | |
| 设置为具有 pg_use_reserved_connections 权限的角色保留的连接槽数量。 | 现存 | ||||
superuser_reserved_connections |
整数 | 重启生效 | 3 |
9.62 次 | |
| 设置为超级用户保留的连接槽数量。 | 现存 | ||||
unix_socket_directories |
字符串 | 重启生效 | /var/run/postgresql |
— | |
| 设置创建 Unix 域套接字的目录。 | 现存 | ||||
unix_socket_directory |
字符串 | 重启生效 | 空字符串 |
— | |
| 设置创建 Unix 域套接字的目录。 | 于 9.3 移除 | ||||
unix_socket_group |
字符串 | 重启生效 | 空字符串 |
— | |
| 设置 Unix 域套接字的所属组。 | 现存 | ||||
unix_socket_permissions |
整数 | 重启生效 | 511 |
— | |
| 设置 Unix 域套接字的访问权限。 | 现存 | ||||
| TCP 设置 5 | |||||
client_connection_check_interval |
整数 | 会话 | 0 ms |
— | |
| 设置查询运行期间检查客户端断连的时间间隔。 | 现存 | ||||
tcp_keepalives_count |
整数 | 会话 | 0 |
— | |
| 设置 TCP keepalive 的最大重传次数。 | 现存 | ||||
tcp_keepalives_idle |
整数 | 会话 | 0 s |
— | |
| 设置开始发送 TCP keepalive 前的空闲时间。 | 现存 | ||||
tcp_keepalives_interval |
整数 | 会话 | 0 s |
— | |
| 设置 TCP keepalive 重传之间的间隔。 | 现存 | ||||
tcp_user_timeout |
整数 | 会话 | 0 ms |
— | |
| 设置 TCP 用户超时。 | 现存 | ||||
| 认证 10 | |||||
authentication_timeout |
整数 | 重载生效 | 1 min |
— | |
| 设置完成客户端认证所允许的最长时间。 | 现存 | ||||
db_user_namespace |
布尔 | 重载生效 | off |
— | |
| 启用按数据库划分的用户名空间。 | 于 17 移除 | ||||
gss_accept_delegation |
布尔 | 重载生效 | off |
— | |
| 设置是否接受客户端的 GSSAPI 凭据委派。 | 现存 | ||||
krb_caseins_users |
布尔 | 重载生效 | off |
— | |
| 设置 Kerberos 和 GSSAPI 用户名是否按大小写不敏感方式处理。 | 现存 | ||||
krb_server_keyfile |
字符串 | 重载生效 | FILE:/etc/postgresql-common/krb5.keytab |
9.11 次 | |
| 设置 Kerberos 服务器密钥文件的位置。 | 现存 | ||||
md5_password_warnings |
布尔 | 会话 | on |
— | |
| 启用关于 MD5 密码的弃用警告。 | 现存 | ||||
oauth_validator_libraries |
字符串 | 重载生效 | 空字符串 |
— | |
| 列出可用于验证 OAuth 2.0 Bearer Token 的库。 | 现存 | ||||
password_encryption |
枚举 | 会话 | scram-sha-256 |
142 次 | |
| 选择生成密码密文时使用的算法。 | 现存 | ||||
password_expiration_warning_threshold |
整数 | 重载生效 | 7 d |
— | |
| 设置密码到期告警的提前时间阈值。 | 现存 | ||||
scram_iterations |
整数 | 会话 | 4096 |
— | |
| 设置生成 SCRAM 密文时使用的迭代次数。 | 现存 | ||||
| 安全和认证 2 | |||||
krb_srvname |
字符串 | 重载生效 | postgres |
— | |
| 设置 Kerberos 服务名称。 | 于 9.4 移除 | ||||
ssl_renegotiation_limit |
整数 | 会话 | 0 B |
— | |
| 设置重新协商加密密钥前允许收发的流量。 | 于 9.5 移除 | ||||
| SSL 17 | |||||
ssl |
布尔 | 重载生效 | off |
101 次 | |
| 启用 SSL/TLS 连接。 | 现存 | ||||
ssl_ca_file |
字符串 | 重载生效 | 空字符串 |
101 次 | |
| 设置 SSL 证书颁发机构文件的位置。 | 现存 | ||||
ssl_cert_file |
字符串 | 重载生效 | server.crt |
101 次 | |
| 设置 SSL 服务器证书文件的位置。 | 现存 | ||||
ssl_ciphers |
字符串 | 重载生效 | HIGH:MEDIUM:+3DES:!aNULL |
103 次 | |
| 设置 TLS 1.2 及更低版本允许使用的密码套件列表。 | 现存 | ||||
ssl_crl_dir |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置 SSL 证书吊销列表目录的位置。 | 现存 | ||||
ssl_crl_file |
字符串 | 重载生效 | 空字符串 |
101 次 | |
| 设置 SSL 证书吊销列表文件的位置。 | 现存 | ||||
ssl_dh_params_file |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置 SSL DH 参数文件的位置。 | 现存 | ||||
ssl_ecdh_curve |
字符串 | 重载生效 | prime256v1 |
101 次 | |
| 设置 ECDH 使用的椭圆曲线。 | 于 18 移除 | ||||
ssl_groups |
字符串 | 重载生效 | X25519:prime256v1 |
— | |
| 设置 Diffie-Hellman 密钥交换使用的组。 | 现存 | ||||
ssl_key_file |
字符串 | 重载生效 | server.key |
101 次 | |
| 设置 SSL 服务器私钥文件的位置。 | 现存 | ||||
ssl_max_protocol_version |
枚举 | 重载生效 | 空字符串 |
— | |
| 设置允许使用的最高 SSL/TLS 协议版本。 | 现存 | ||||
ssl_min_protocol_version |
枚举 | 重载生效 | TLSv1.2 |
131 次 | |
| 设置允许使用的最低 SSL/TLS 协议版本。 | 现存 | ||||
ssl_passphrase_command |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置用于获取 SSL 私钥口令的命令。 | 现存 | ||||
ssl_passphrase_command_supports_reload |
布尔 | 重载生效 | off |
— | |
| 控制重新加载服务器配置时是否调用 ssl_passphrase_command。 | 现存 | ||||
ssl_prefer_server_ciphers |
布尔 | 重载生效 | on |
101 次 | |
| 优先采用服务器端的密码套件顺序。 | 现存 | ||||
ssl_sni |
布尔 | 重载生效 | off |
— | |
| 设置是否解释 SSL 连接中的 SNI 扩展。 | 现存 | ||||
ssl_tls13_ciphers |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置 TLS 1.3 允许使用的密码套件列表。 | 现存 | ||||
| 内存 23 | |||||
autovacuum_work_mem |
整数 | 重载生效 | -1 kB |
— | |
| 设置每个 autovacuum 工作进程可使用的最大内存。 | 现存 | ||||
commit_timestamp_buffers |
整数 | 重启生效 | 0 B (0 × 8kB) |
— | |
| 设置提交时间戳缓存专用缓冲池的大小。 | 现存 | ||||
dynamic_shared_memory_type |
枚举 | 重启生效 | posix |
121 次 | |
| 选择动态共享内存实现。 | 现存 | ||||
hash_mem_multiplier |
浮点 | 会话 | 2 |
151 次 | |
| 以 work_mem 的倍数确定哈希表内存上限。 | 现存 | ||||
huge_page_size |
整数 | 重启生效 | 0 B |
— | |
| 设置 PostgreSQL 请求的显式大页大小。 | 现存 | ||||
huge_pages |
枚举 | 重启生效 | try |
— | |
| 控制在 Linux 或 Windows 上使用大页。 | 现存 | ||||
logical_decoding_work_mem |
整数 | 会话 | 64 MiB |
— | |
| 设置逻辑解码使用的最大内存。 | 现存 | ||||
maintenance_work_mem |
整数 | 会话 | 64 MiB |
172 次 | |
| 设置维护操作可使用的最大内存。 | 现存 | ||||
max_prepared_transactions |
整数 | 重启生效 | 0 |
9.62 次 | |
| 设置可同时处于 prepared 状态的事务上限。 | 现存 | ||||
max_stack_depth |
整数 | 会话（超级用户） | 100 KiB |
— | |
| 设置 PostgreSQL 认为安全的最大执行栈深度。 | 现存 | ||||
min_dynamic_shared_memory |
整数 | 重启生效 | 0 B |
— | |
| 设置启动时为并行查询预留的动态共享内存。 | 现存 | ||||
multixact_member_buffers |
整数 | 重启生效 | 256 KiB (32 × 8kB) |
— | |
| 设置 MultiXact member 缓存专用缓冲池的大小。 | 现存 | ||||
multixact_offset_buffers |
整数 | 重启生效 | 128 KiB (16 × 8kB) |
— | |
| 设置 MultiXact offset 缓存专用缓冲池的大小。 | 现存 | ||||
notify_buffers |
整数 | 重启生效 | 128 KiB (16 × 8kB) |
— | |
| 设置 LISTEN/NOTIFY 消息缓存专用缓冲池的大小。 | 现存 | ||||
replacement_sort_tuples |
整数 | 会话 | 150000 |
— | |
| 设置使用替换选择排序的最大元组数。 | 于 11 移除 | ||||
serializable_buffers |
整数 | 重启生效 | 256 KiB (32 × 8kB) |
— | |
| 设置可串行化事务缓存专用缓冲池的大小。 | 现存 | ||||
shared_buffers |
整数 | 重启生效 | 128 MiB (16384 × 8kB) |
151 次 | |
| 设置服务器使用的共享缓冲区数量。 | 现存 | ||||
shared_memory_type |
枚举 | 重启生效 | mmap |
— | |
| 选择主共享内存区域的实现。 | 现存 | ||||
subtransaction_buffers |
整数 | 重启生效 | 0 B (0 × 8kB) |
— | |
| 设置子事务状态缓存专用缓冲池的大小。 | 现存 | ||||
temp_buffers |
整数 | 会话 | 8 MiB (1024 × 8kB) |
— | |
| 设置每个会话使用的最大临时缓冲区内存。 | 现存 | ||||
transaction_buffers |
整数 | 重启生效 | 0 B (0 × 8kB) |
— | |
| 设置事务状态缓存专用缓冲池的大小。 | 现存 | ||||
vacuum_buffer_usage_limit |
整数 | 会话 | 2 MiB |
171 次 | |
| 设置 VACUUM、ANALYZE 与 autovacuum 的缓冲区访问环大小。 | 现存 | ||||
work_mem |
整数 | 会话 | 4 MiB |
9.41 次 | |
| 设置查询工作区可使用的最大内存。 | 现存 | ||||
| 磁盘 4 | |||||
file_copy_method |
枚举 | 会话 | copy |
— | |
| 选择数据库文件的复制方法。 | 现存 | ||||
file_extend_method |
枚举 | 重载生效 | posix_fallocate |
— | |
| 选择扩展数据文件的方法。 | 现存 | ||||
max_notify_queue_pages |
整数 | 重启生效 | 1048576 |
— | |
| 设置 LISTEN/NOTIFY 队列最多分配的页面数。 | 现存 | ||||
temp_file_limit |
整数 | 会话（超级用户） | -1 kB |
— | |
| 限制每个 PostgreSQL 进程使用的全部临时文件总大小。 | 现存 | ||||
| 内核资源 1 | |||||
max_files_per_process |
整数 | 重启生效 | 1000 |
131 次 | |
| 设置每个服务器进程可同时打开的最大文件数。 | 现存 | ||||
| 计时 1 | |||||
timing_clock_source |
枚举 | 会话（超级用户） | auto |
— | |
| 控制收集计时测量时使用的时钟来源。 | 现存 | ||||
| 后台写入器 4 | |||||
bgwriter_delay |
整数 | 重载生效 | 200 ms |
— | |
| 设置后台写进程两轮工作之间的休眠时间。 | 现存 | ||||
bgwriter_flush_after |
整数 | 重载生效 | 512 KiB (64 × 8kB) |
— | |
| 设置后台写进程写出多少页面后请求操作系统下刷。 | 现存 | ||||
bgwriter_lru_maxpages |
整数 | 重载生效 | 100 |
101 次 | |
| 设置后台写进程每轮最多刷新的 LRU 页面数。 | 现存 | ||||
bgwriter_lru_multiplier |
浮点 | 重载生效 | 2 |
— | |
| 设置为预计近期缓冲区需求预留清洁页面的倍数。 | 现存 | ||||
| I/O 12 | |||||
backend_flush_after |
整数 | 会话 | 0 B (0 × 8kB) |
— | |
| 设置单个后端写出多少页面后请求操作系统下刷。 | 现存 | ||||
effective_io_concurrency |
整数 | 会话 | 16 |
181 次 | |
| 设置单个会话可高效利用的存储并发度。 | 现存 | ||||
io_combine_limit |
整数 | 会话 | 128 KiB (16 × 8kB) |
181 次 | |
| 限制合并读写操作的最大数据量。 | 现存 | ||||
io_max_combine_limit |
整数 | 重启生效 | 128 KiB (16 × 8kB) |
— | |
| 设置钳制 io_combine_limit 的服务器级上限。 | 现存 | ||||
io_max_concurrency |
整数 | 重启生效 | -1 |
— | |
| 设置单个进程可同时执行的最大 I/O 数。 | 现存 | ||||
io_max_workers |
整数 | 重载生效 | 8 |
— | |
| 设置 io_method=worker 时 I/O worker 进程的最大数量。 | 现存 | ||||
io_method |
枚举 | 重启生效 | worker |
— | |
| 选择 PostgreSQL 执行异步 I/O 操作的方法。 | 现存 | ||||
io_min_workers |
整数 | 重载生效 | 2 |
— | |
| 设置 io_method=worker 时 I/O worker 进程的最小数量。 | 现存 | ||||
io_worker_idle_timeout |
整数 | 重载生效 | 1 min |
— | |
| 设置 io_method=worker 时空闲 I/O worker 退出前的最长等待时间。 | 现存 | ||||
io_worker_launch_interval |
整数 | 重载生效 | 100 ms |
— | |
| 设置 io_method=worker 时启动新 I/O worker 的最小间隔。 | 现存 | ||||
io_workers |
整数 | 重载生效 | 3 |
— | |
| 设置 io_method=worker 时使用的 I/O 工作进程数。 | 于 19 移除 | ||||
maintenance_io_concurrency |
整数 | 会话 | 16 |
181 次 | |
| 设置维护操作可利用的存储 I/O 并发度。 | 现存 | ||||
| 异步行为 1 | |||||
old_snapshot_threshold |
整数 | 重启生效 | -1 min |
— | |
| 设置快照因过旧而不能读取后来被修改页面的时间阈值。 | 于 17 移除 | ||||
| 工作进程 5 | |||||
max_parallel_maintenance_workers |
整数 | 会话 | 2 |
— | |
| 设置单次维护操作最多使用的并行工作进程数。 | 现存 | ||||
max_parallel_workers |
整数 | 会话 | 8 |
— | |
| 设置集群内可同时活动的并行工作进程总数。 | 现存 | ||||
max_parallel_workers_per_gather |
整数 | 会话 | 2 |
101 次 | |
| 设置单个 Gather 节点最多请求的并行工作进程数。 | 现存 | ||||
max_worker_processes |
整数 | 重启生效 | 8 |
9.61 次 | |
| 设置并发后台工作进程的总上限。 | 现存 | ||||
parallel_leader_participation |
布尔 | 会话 | on |
— | |
| 控制 Gather 或 Gather Merge 的 leader 是否也执行子计划。 | 现存 | ||||
| 设置 15 | |||||
commit_delay |
整数 | 会话（超级用户） | 0 |
9.31 次 | |
| 设置事务提交与将 WAL 刷入磁盘之间的延迟（微秒）。 | 现存 | ||||
commit_siblings |
整数 | 会话 | 5 |
9.11 次 | |
| 设置启用 commit_delay 前所需的并发活动事务最低数量。 | 现存 | ||||
fsync |
布尔 | 重载生效 | on |
— | |
| 强制将更新同步到磁盘。 | 现存 | ||||
full_page_writes |
布尔 | 重载生效 | on |
— | |
| 检查点后页面首次修改时将完整页面写入 WAL。 | 现存 | ||||
synchronous_commit |
枚举 | 会话 | on |
9.63 次 | |
| 设置当前事务提交时使用的同步级别。 | 现存 | ||||
wal_buffers |
整数 | 重启生效 | -1 8kB |
9.11 次 | |
| 设置共享内存中用于 WAL 的磁盘页缓冲区数量。 | 现存 | ||||
wal_compression |
枚举 | 会话（超级用户） | off |
151 次 | |
| 使用指定方法压缩写入 WAL 的整页映像。 | 现存 | ||||
wal_init_zero |
布尔 | 会话（超级用户） | on |
— | |
| 新 WAL 文件首次使用前先写零。 | 现存 | ||||
wal_level |
枚举 | 重启生效 | replica |
103 次 | |
| 设置写入 WAL 的信息级别。 | 现存 | ||||
wal_log_hints |
布尔 | 重启生效 | off |
— | |
| 页面在检查点后首次发生非关键修改时也将完整页面写入 WAL。 | 现存 | ||||
wal_recycle |
布尔 | 会话（超级用户） | on |
— | |
| 通过重命名复用 WAL 文件。 | 现存 | ||||
wal_skip_threshold |
整数 | 会话 | 2 MiB |
— | |
| 设置用 fsync 新文件代替写 WAL 的最小文件规模。 | 现存 | ||||
wal_sync_method |
枚举 | 重载生效 | fdatasync |
— | |
| 选择将 WAL 更新强制写入磁盘的方法。 | 现存 | ||||
wal_writer_delay |
整数 | 重载生效 | 200 ms |
— | |
| 设置 WAL writer 两次刷写之间的时间。 | 现存 | ||||
wal_writer_flush_after |
整数 | 重载生效 | 1 MiB (128 × 8kB) |
— | |
| 设置触发 WAL writer 刷盘的写出 WAL 数量。 | 现存 | ||||
| 检查点 7 | |||||
checkpoint_completion_target |
浮点 | 重载生效 | 0.9 |
141 次 | |
| 设置在检查点间隔中用于刷新脏缓冲区的目标时间比例。 | 现存 | ||||
checkpoint_flush_after |
整数 | 重载生效 | 256 KiB (32 × 8kB) |
— | |
| 设置检查点每写入多少页后刷出先前写入的数据。 | 现存 | ||||
checkpoint_segments |
整数 | 重载生效 | 3 |
— | |
| 设置两次自动 WAL 检查点之间允许的最大日志段距离。 | 于 9.5 移除 | ||||
checkpoint_timeout |
整数 | 重载生效 | 5 min |
9.61 次 | |
| 设置两次自动 WAL 检查点之间的最长时间。 | 现存 | ||||
checkpoint_warning |
整数 | 重载生效 | 30 s |
— | |
| 设置 WAL 容量触发的检查点过于频繁时发出警告的时间阈值。 | 现存 | ||||
max_wal_size |
整数 | 重载生效 | 1 GiB |
101 次 | |
| 设置触发自动检查点的 WAL 大小。 | 现存 | ||||
min_wal_size |
整数 | 重载生效 | 80 MiB |
101 次 | |
| 设置 WAL 可收缩到的最小规模。 | 现存 | ||||
| 归档 4 | |||||
archive_command |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置归档 WAL 文件时调用的 shell 命令。 | 现存 | ||||
archive_library |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置归档 WAL 文件时调用的库。 | 现存 | ||||
archive_mode |
枚举 | 重启生效 | off |
9.51 次 | |
| 允许使用 archive_command 归档 WAL 文件。 | 现存 | ||||
archive_timeout |
整数 | 重载生效 | 0 s |
— | |
| 设置强制切换到下一个 WAL 文件前的最长等待时间。 | 现存 | ||||
| 恢复 2 | |||||
recovery_prefetch |
枚举 | 重载生效 | try |
— | |
| 在恢复期间预取 WAL 引用的数据块。 | 现存 | ||||
wal_decode_buffer_size |
整数 | 重启生效 | 512 KiB |
— | |
| 设置恢复期间超前读取 WAL 的缓冲区大小。 | 现存 | ||||
| 归档恢复 3 | |||||
archive_cleanup_command |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置每次重启点执行的 shell 命令。 | 现存 | ||||
recovery_end_command |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置恢复结束时执行一次的 shell 命令。 | 现存 | ||||
restore_command |
字符串 | 重载生效 | 空字符串 |
141 次 | |
| 设置取回归档 WAL 文件时调用的 shell 命令。 | 现存 | ||||
| 恢复目标 8 | |||||
recovery_target |
字符串 | 重启生效 | 空字符串 |
— | |
| 设为 immediate，使恢复在首次达到一致状态时结束。 | 现存 | ||||
recovery_target_action |
枚举 | 重启生效 | pause |
— | |
| 设置到达恢复目标后执行的动作。 | 现存 | ||||
recovery_target_inclusive |
布尔 | 重启生效 | on |
— | |
| 设置是否包含恢复目标所对应的事务。 | 现存 | ||||
recovery_target_lsn |
字符串 | 重启生效 | 空字符串 |
— | |
| 设置恢复所推进到的 WAL LSN。 | 现存 | ||||
recovery_target_name |
字符串 | 重启生效 | 空字符串 |
— | |
| 设置恢复所推进到的命名还原点。 | 现存 | ||||
recovery_target_time |
字符串 | 重启生效 | 空字符串 |
— | |
| 设置恢复所推进到的时间戳。 | 现存 | ||||
recovery_target_timeline |
字符串 | 重启生效 | latest |
— | |
| 指定要恢复到的时间线。 | 现存 | ||||
recovery_target_xid |
字符串 | 重启生效 | 空字符串 |
— | |
| 设置恢复所推进到的事务 ID。 | 现存 | ||||
| WAL 汇总 2 | |||||
summarize_wal |
布尔 | 重载生效 | off |
— | |
| 启动 WAL summarizer 进程以支持增量备份。 | 现存 | ||||
wal_summary_keep_time |
整数 | 重载生效 | 10 d |
— | |
| 设置 WAL 摘要文件的保留时间。 | 现存 | ||||
| 发送服务器 12 | |||||
idle_replication_slot_timeout |
整数 | 重载生效 | 0 s |
— | |
| 设置复制槽保持空闲多久后失效。 | 现存 | ||||
max_repack_replication_slots |
整数 | 重启生效 | 5 |
— | |
| 设置 REPACK 命令可使用的最大复制槽数量。 | 现存 | ||||
max_replication_slots |
整数 | 重启生效 | 10 |
102 次 | |
| 设置可同时定义的复制槽最大数量。 | 现存 | ||||
max_slot_wal_keep_size |
整数 | 重载生效 | -1 MB |
— | |
| 设置复制槽可保留的 WAL 最大大小。 | 现存 | ||||
max_wal_senders |
整数 | 重启生效 | 10 |
103 次 | |
| 设置可同时运行的 WAL sender 进程最大数量。 | 现存 | ||||
output_plugin_libraries |
字符串 | 会话（超级用户） | pgoutput, test_decoding |
— | |
| 列出可作为逻辑解码输出插件指定的库。 | 现存 | ||||
replication_timeout |
整数 | 重载生效 | 1 min |
— | |
| 设置等待 WAL 复制活动的最长时间。 | 于 9.3 移除 | ||||
track_commit_timestamp |
布尔 | 重启生效 | off |
— | |
| 记录事务提交时间。 | 现存 | ||||
wal_keep_segments |
整数 | 重载生效 | 0 |
— | |
| 设置为备库保留的 WAL 文件数量。 | 于 13 移除 | ||||
wal_keep_size |
整数 | 重载生效 | 0 B |
— | |
| 设置为备库保留的 WAL 文件大小。 | 现存 | ||||
wal_sender_shutdown_timeout |
整数 | 会话 | -1 ms |
— | |
| 设置关机时等待 WAL 全部复制到接收端的最长时间。 | 现存 | ||||
wal_sender_timeout |
整数 | 会话 | 1 min |
121 次 | |
| 设置等待 WAL 复制活动的最长时间。 | 现存 | ||||
| 主服务器 1 | |||||
wal_sender_delay |
整数 | 重载生效 | 1 s |
9.11 次 | |
| 设置 WAL sender 两次复制动作之间的休眠时间。 | 于 9.2 移除 | ||||
| 主库 3 | |||||
synchronized_standby_slots |
字符串 | 重载生效 | 空字符串 |
— | |
| 列出逻辑 WAL sender 必须等待的流复制备库槽。 | 现存 | ||||
synchronous_standby_names |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置同步备库数量及候选备库名称列表。 | 现存 | ||||
vacuum_defer_cleanup_age |
整数 | 重载生效 | 0 |
— | |
| 设置 VACUUM 与 HOT 清理要延后多少个事务。 | 于 16 移除 | ||||
| 备库 13 | |||||
hot_standby |
布尔 | 重启生效 | on |
101 次 | |
| 允许在恢复期间连接并执行查询。 | 现存 | ||||
hot_standby_feedback |
布尔 | 重载生效 | off |
— | |
| 允许热备库向主库反馈信息，以避免查询冲突。 | 现存 | ||||
max_standby_archive_delay |
整数 | 重载生效 | 30 s |
9.11 次 | |
| 设置热备处理归档 WAL 时，取消冲突查询前允许的最大延迟。 | 现存 | ||||
max_standby_streaming_delay |
整数 | 重载生效 | 30 s |
9.11 次 | |
| 设置热备处理流式 WAL 时，取消冲突查询前允许的最大延迟。 | 现存 | ||||
primary_conninfo |
字符串 | 重载生效 | 空字符串 |
131 次 | |
| 设置连接发送端服务器时使用的连接字符串。 | 现存 | ||||
primary_slot_name |
字符串 | 重载生效 | 空字符串 |
131 次 | |
| 设置连接发送端服务器时使用的复制槽名称。 | 现存 | ||||
promote_trigger_file |
字符串 | 重载生效 | 空字符串 |
— | |
| 指定一个文件，其出现会使备库结束恢复。 | 于 16 移除 | ||||
recovery_min_apply_delay |
整数 | 重载生效 | 0 ms |
— | |
| 设置恢复期间应用变更的最小延迟。 | 现存 | ||||
sync_replication_slots |
布尔 | 重载生效 | off |
— | |
| 允许物理备库从主库同步逻辑故障转移复制槽。 | 现存 | ||||
wal_receiver_create_temp_slot |
布尔 | 重载生效 | off |
— | |
| 未配置永久槽时，设置 WAL receiver 是否创建临时复制槽。 | 现存 | ||||
wal_receiver_status_interval |
整数 | 重载生效 | 10 s |
— | |
| 设置 WAL receiver 向发送端报告状态的最大间隔。 | 现存 | ||||
wal_receiver_timeout |
整数 | 重载生效 | 1 min |
191 次 | |
| 设置等待发送端数据的最长时间。 | 现存 | ||||
wal_retrieve_retry_interval |
整数 | 重载生效 | 5 s |
— | |
| 设置 WAL 获取失败后的重试等待时间。 | 现存 | ||||
| 订阅者 4 | |||||
max_active_replication_origins |
整数 | 重启生效 | 10 |
— | |
| 设置可同时活动的复制源最大数量。 | 现存 | ||||
max_logical_replication_workers |
整数 | 重启生效 | 4 |
— | |
| 设置逻辑复制 worker 进程的最大数量。 | 现存 | ||||
max_parallel_apply_workers_per_subscription |
整数 | 重载生效 | 2 |
— | |
| 设置每个订阅的并行应用 worker 最大数量。 | 现存 | ||||
max_sync_workers_per_subscription |
整数 | 重载生效 | 2 |
— | |
| 设置每个订阅的表同步 worker 最大数量。 | 现存 | ||||
| 规划器方法配置 26 | |||||
enable_async_append |
布尔 | 会话 | on |
— | |
| 允许规划器使用异步 Append 计划。 | 现存 | ||||
enable_bitmapscan |
布尔 | 会话 | on |
— | |
| 允许规划器使用位图扫描计划。 | 现存 | ||||
enable_distinct_reordering |
布尔 | 会话 | on |
— | |
| 允许规划器重排 DISTINCT 键。 | 现存 | ||||
enable_eager_aggregate |
布尔 | 会话 | on |
— | |
| 允许规划器把部分聚合提前推过连接。 | 现存 | ||||
enable_gathermerge |
布尔 | 会话 | on |
— | |
| 允许规划器使用 Gather Merge 计划。 | 现存 | ||||
enable_group_by_reordering |
布尔 | 会话 | on |
— | |
| 允许规划器重排 GROUP BY 键。 | 现存 | ||||
enable_groupagg |
布尔 | — | — | ||
| 启用或禁用查询规划器使用基于排序的分组和聚合计划类型。 | 现存 | ||||
enable_hashagg |
布尔 | 会话 | on |
— | |
| 允许规划器使用哈希聚合计划。 | 现存 | ||||
enable_hashjoin |
布尔 | 会话 | on |
— | |
| 允许规划器使用哈希连接计划。 | 现存 | ||||
enable_incremental_sort |
布尔 | 会话 | on |
— | |
| 允许规划器使用增量排序步骤。 | 现存 | ||||
enable_indexonlyscan |
布尔 | 会话 | on |
— | |
| 允许规划器使用仅索引扫描计划。 | 现存 | ||||
enable_indexscan |
布尔 | 会话 | on |
— | |
| 允许规划器使用索引扫描计划。 | 现存 | ||||
enable_material |
布尔 | 会话 | on |
— | |
| 允许规划器插入物化节点。 | 现存 | ||||
enable_memoize |
布尔 | 会话 | on |
— | |
| 允许规划器使用 Memoize 缓存节点。 | 现存 | ||||
enable_mergejoin |
布尔 | 会话 | on |
— | |
| 允许规划器使用归并连接计划。 | 现存 | ||||
enable_nestloop |
布尔 | 会话 | on |
— | |
| 允许规划器使用嵌套循环连接计划。 | 现存 | ||||
enable_parallel_append |
布尔 | 会话 | on |
— | |
| 允许规划器使用并行感知的 Append 计划。 | 现存 | ||||
enable_parallel_hash |
布尔 | 会话 | on |
— | |
| 允许规划器使用并行哈希计划。 | 现存 | ||||
enable_partition_pruning |
布尔 | 会话 | on |
— | |
| 允许在规划和执行阶段裁剪分区。 | 现存 | ||||
enable_partitionwise_aggregate |
布尔 | 会话 | off |
— | |
| 允许按分区执行聚合与分组。 | 现存 | ||||
enable_partitionwise_join |
布尔 | 会话 | off |
— | |
| 允许按匹配分区执行连接。 | 现存 | ||||
enable_presorted_aggregate |
布尔 | 会话 | on |
— | |
| 允许规划器为带 ORDER BY 或 DISTINCT 的聚合提供预排序输入。 | 现存 | ||||
enable_self_join_elimination |
布尔 | 会话 | on |
— | |
| 允许消除可证明冗余的唯一自连接。 | 现存 | ||||
enable_seqscan |
布尔 | 会话 | on |
— | |
| 允许规划器使用顺序扫描计划。 | 现存 | ||||
enable_sort |
布尔 | 会话 | on |
— | |
| 允许规划器使用显式排序步骤。 | 现存 | ||||
enable_tidscan |
布尔 | 会话 | on |
— | |
| 允许规划器使用 TID 扫描计划。 | 现存 | ||||
| 规划器代价常量 15 | |||||
cpu_index_tuple_cost |
浮点 | 会话 | 0.005 |
— | |
| 设置规划器处理每个索引条目的成本估计。 | 现存 | ||||
cpu_operator_cost |
浮点 | 会话 | 0.0025 |
— | |
| 设置规划器执行每个操作符或函数调用的成本估计。 | 现存 | ||||
cpu_tuple_cost |
浮点 | 会话 | 0.01 |
— | |
| 设置规划器处理每个元组（行）的成本估计。 | 现存 | ||||
effective_cache_size |
整数 | 会话 | 4 GiB (524288 × 8kB) |
9.41 次 | |
| 设置规划器对有效数据缓存总规模的假设。 | 现存 | ||||
jit_above_cost |
浮点 | 会话 | 100000 |
— | |
| 设置启用 JIT 编译的查询成本阈值。 | 现存 | ||||
jit_inline_above_cost |
浮点 | 会话 | 500000 |
— | |
| 设置 JIT 尝试内联的查询成本阈值。 | 现存 | ||||
jit_optimize_above_cost |
浮点 | 会话 | 500000 |
— | |
| 设置 JIT 执行昂贵优化的查询成本阈值。 | 现存 | ||||
min_eager_agg_group_size |
浮点 | 会话 | 8 |
— | |
| 设置考虑提前聚合所需的最小平均分组大小。 | 现存 | ||||
min_parallel_index_scan_size |
整数 | 会话 | 512 KiB (64 × 8kB) |
— | |
| 设置考虑并行索引扫描所需的最小索引数据量。 | 现存 | ||||
min_parallel_relation_size |
整数 | 会话 | 8 MiB (1024 × 8kB) |
— | |
| 设置可考虑并行扫描的关系最小尺寸。 | 于 10 移除 | ||||
min_parallel_table_scan_size |
整数 | 会话 | 8 MiB (1024 × 8kB) |
— | |
| 设置考虑并行表扫描所需的最小表数据量。 | 现存 | ||||
parallel_setup_cost |
浮点 | 会话 | 1000 |
— | |
| 设置规划器启动并行工作进程的成本估计。 | 现存 | ||||
parallel_tuple_cost |
浮点 | 会话 | 0.1 |
— | |
| 设置把每行从并行 worker 传给 leader 的成本估计。 | 现存 | ||||
random_page_cost |
浮点 | 会话 | 4 |
— | |
| 设置规划器对非顺序读取页面的相对成本估计。 | 现存 | ||||
seq_page_cost |
浮点 | 会话 | 1 |
— | |
| 设置规划器顺序读取磁盘页面的成本估计。 | 现存 | ||||
| 遗传查询优化 7 | |||||
geqo |
布尔 | 会话 | on |
— | |
| 启用遗传查询优化。 | 现存 | ||||
geqo_effort |
整数 | 会话 | 5 |
— | |
| 设置 GEQO 用于推导其他参数默认值的工作强度。 | 现存 | ||||
geqo_generations |
整数 | 会话 | 0 |
— | |
| 设置 GEQO 算法迭代代数。 | 现存 | ||||
geqo_pool_size |
整数 | 会话 | 0 |
— | |
| 设置 GEQO 种群中的个体数。 | 现存 | ||||
geqo_seed |
浮点 | 会话 | 0 |
— | |
| 设置 GEQO 随机路径选择的种子。 | 现存 | ||||
geqo_selection_bias |
浮点 | 会话 | 2 |
— | |
| 设置 GEQO 种群内的选择压力。 | 现存 | ||||
geqo_threshold |
整数 | 会话 | 12 |
— | |
| 设置 FROM 项达到多少时改用 GEQO。 | 现存 | ||||
| 其他规划器选项 8 | |||||
constraint_exclusion |
枚举 | 会话 | partition |
— | |
| 允许规划器利用约束排除不可能匹配的表。 | 现存 | ||||
cursor_tuple_fraction |
浮点 | 会话 | 0.1 |
— | |
| 设置规划器对游标实际取回行比例的估计。 | 现存 | ||||
default_statistics_target |
整数 | 会话 | 100 |
— | |
| 设置未单独指定目标值的列所使用的默认统计目标。 | 现存 | ||||
from_collapse_limit |
整数 | 会话 | 8 |
— | |
| 设置不再折叠子查询的 FROM 列表规模阈值。 | 现存 | ||||
jit |
布尔 | 会话 | on |
192 次 | |
| 在 JIT 可用且成本规则选中查询时允许即时编译。 | 现存 | ||||
join_collapse_limit |
整数 | 会话 | 8 |
— | |
| 设置不再展平 JOIN 构造的 FROM 列表规模阈值。 | 现存 | ||||
plan_cache_mode |
枚举 | 会话 | auto |
— | |
| 控制规划器选择自定义计划还是通用计划。 | 现存 | ||||
recursive_worktable_factor |
浮点 | 会话 | 10 |
— | |
| 设置递归查询工作表平均大小的规划器估计倍数。 | 现存 | ||||
| 记录到哪里 14 | |||||
event_source |
字符串 | 重启生效 | PostgreSQL |
— | |
| 设置在 Windows 事件日志中标识 PostgreSQL 消息的应用名称。 | 现存 | ||||
log_destination |
字符串 | 重载生效 | stderr |
— | |
| 设置服务器日志输出的目标。 | 现存 | ||||
log_directory |
字符串 | 重载生效 | log |
101 次 | |
| 设置日志文件的目标目录。 | 现存 | ||||
log_file_mode |
整数 | 重载生效 | 384 |
— | |
| 设置日志文件的权限模式。 | 现存 | ||||
log_filename |
字符串 | 重载生效 | postgresql-%Y-%m-%d_%H%M%S.log |
— | |
| 设置日志文件名模式。 | 现存 | ||||
log_rotation_age |
整数 | 重载生效 | 1 d |
— | |
| 设置强制轮转日志文件前等待的时间。 | 现存 | ||||
log_rotation_size |
整数 | 重载生效 | 10 MiB |
181 次 | |
| 设置触发轮转前单个日志文件可达到的最大大小。 | 现存 | ||||
log_truncate_on_rotation |
布尔 | 重载生效 | off |
— | |
| 轮转时截断同名的既有日志文件。 | 现存 | ||||
logging_collector |
布尔 | 重启生效 | off |
— | |
| 启动子进程，将 stderr、csvlog 和/或 jsonlog 捕获到日志文件。 | 现存 | ||||
silent_mode |
布尔 | 重启生效 | off |
— | |
| 让服务器以静默模式运行。 | 于 9.2 移除 | ||||
syslog_facility |
枚举 | 重载生效 | local0 |
— | |
| 设置启用 syslog 时使用的 facility。 | 现存 | ||||
syslog_ident |
字符串 | 重载生效 | postgres |
— | |
| 设置在 syslog 中标识 PostgreSQL 消息的程序名。 | 现存 | ||||
syslog_sequence_numbers |
布尔 | 重载生效 | on |
— | |
| 为 syslog 消息添加序号以避免重复消息被抑制。 | 现存 | ||||
syslog_split_messages |
布尔 | 重载生效 | on |
— | |
| 按行并按 1024 字节限制拆分发送给 syslog 的消息。 | 现存 | ||||
| 何时记录 7 | |||||
log_min_duration_sample |
整数 | 会话（超级用户） | -1 ms |
— | |
| 设置进入语句抽样记录所需达到的最短执行时间，抽样由 log_statement_sample_rate 决定。 | 现存 | ||||
log_min_duration_statement |
整数 | 会话（超级用户） | -1 ms |
9.11 次 | |
| 记录运行时间达到配置阈值的已完成语句。 | 现存 | ||||
log_min_error_statement |
枚举 | 会话（超级用户） | error |
— | |
| 记录所有产生不低于指定级别错误的语句。 | 现存 | ||||
log_min_messages |
枚举 | 会话（超级用户） | warning |
191 次 | |
| 设置写入服务器日志的消息级别。 | 现存 | ||||
log_startup_progress_interval |
整数 | 重载生效 | 10 s |
— | |
| 设置耗时启动操作的进度日志间隔。 | 现存 | ||||
log_statement_sample_rate |
浮点 | 会话（超级用户） | 1 |
— | |
| 设置超过 log_min_duration_sample 的语句被记录的比例。 | 现存 | ||||
log_transaction_sample_rate |
浮点 | 会话（超级用户） | 0 |
— | |
| 设置抽取整笔事务并记录其中所有语句的比例。 | 现存 | ||||
| 记录什么 25 | |||||
application_name |
字符串 | 会话 | 空字符串 |
— | |
| 设置在统计信息和日志中报告的应用名称。 | 现存 | ||||
debug_pretty_print |
布尔 | 会话 | on |
— | |
| 对解析树和计划树的显示进行缩进美化。 | 现存 | ||||
debug_print_parse |
布尔 | 会话 | off |
— | |
| 记录每个查询的解析树。 | 现存 | ||||
debug_print_plan |
布尔 | 会话 | off |
— | |
| 记录每个查询的执行计划树。 | 现存 | ||||
debug_print_raw_parse |
布尔 | 会话 | off |
— | |
| 把每条查询的原始解析树写入日志。 | 现存 | ||||
debug_print_rewritten |
布尔 | 会话 | off |
— | |
| 记录每个查询重写后的解析树。 | 现存 | ||||
log_autoanalyze_min_duration |
整数 | 重载生效 | 10 min |
— | |
| 设置记录 autovacuum ANALYZE 动作的最短执行时间。 | 现存 | ||||
log_autovacuum_min_duration |
整数 | 重载生效 | 10 min |
152 次 | |
| 设置记录 autovacuum 操作所需达到的最短执行时间。 | 现存 | ||||
log_checkpoints |
布尔 | 重载生效 | on |
151 次 | |
| 记录每次检查点。 | 现存 | ||||
log_connections |
字符串 | 连接时（超级用户） | 空字符串 |
182 次 | |
| 记录连接建立与初始化过程中的指定阶段。 | 现存 | ||||
log_disconnections |
布尔 | 连接时（超级用户） | off |
9.51 次 | |
| 记录会话结束及其持续时间。 | 现存 | ||||
log_duration |
布尔 | 会话（超级用户） | off |
— | |
| 记录每条已完成 SQL 语句的执行时长。 | 现存 | ||||
log_error_verbosity |
枚举 | 会话（超级用户） | default |
— | |
| 设置日志消息的详细程度。 | 现存 | ||||
log_hostname |
布尔 | 重载生效 | off |
— | |
| 在连接日志中记录主机名。 | 现存 | ||||
log_line_prefix |
字符串 | 重载生效 | %m [%p] |
101 次 | |
| 控制每行日志前添加的信息。 | 现存 | ||||
log_lock_failures |
布尔 | 会话（超级用户） | off |
— | |
| 记录锁获取失败。 | 现存 | ||||
log_lock_waits |
布尔 | 会话（超级用户） | off |
191 次 | |
| 记录持续时间较长的锁等待。 | 现存 | ||||
log_parameter_max_length |
整数 | 会话（超级用户） | -1 B |
— | |
| 设置记录语句时绑定参数值可写入日志的最大字节数。 | 现存 | ||||
log_parameter_max_length_on_error |
整数 | 会话 | 0 B |
— | |
| 设置发生错误时绑定参数值可写入日志的最大字节数。 | 现存 | ||||
log_recovery_conflict_waits |
布尔 | 重载生效 | off |
— | |
| 记录备用库恢复冲突等待。 | 现存 | ||||
log_replication_commands |
布尔 | 会话（超级用户） | off |
— | |
| 记录每条复制命令。 | 现存 | ||||
log_statement |
枚举 | 会话（超级用户） | none |
— | |
| 设置要记录的 SQL 语句类型。 | 现存 | ||||
log_statement_max_length |
整数 | — | — | ||
| 如果大于零，通过 log_statement、log_min_duration_statement、log_min_duration_sample 或 log_transaction_sample_rate 记录的每条语句，其文本都会被截断为最多这么多字节。 | 现存 | ||||
log_temp_files |
整数 | 会话（超级用户） | -1 kB |
— | |
| 记录大于指定千字节数的临时文件使用。 | 现存 | ||||
log_timezone |
字符串 | 重载生效 | GMT |
9.22 次 | |
| 设置日志消息使用的时区。 | 现存 | ||||
| 进程标题 2 | |||||
cluster_name |
字符串 | 重启生效 | 空字符串 |
— | |
| 设置显示在进程标题中的集群名称。 | 现存 | ||||
update_process_title |
布尔 | 会话（超级用户） | on |
— | |
| 更新进程标题以显示当前 SQL 命令。 | 现存 | ||||
| 累积查询和索引统计 8 | |||||
stats_fetch_consistency |
枚举 | 会话 | cache |
— | |
| 设置读取累计统计信息时的一致性方式。 | 现存 | ||||
track_activities |
布尔 | 会话（超级用户） | on |
— | |
| 收集会话当前执行命令的信息。 | 现存 | ||||
track_activity_query_size |
整数 | 重启生效 | 1 KiB |
132 次 | |
| 设置 pg_stat_activity.query 预留的字节数。 | 现存 | ||||
track_cost_delay_timing |
布尔 | 会话（超级用户） | off |
— | |
| 收集基于成本的 vacuum 延迟计时。 | 现存 | ||||
track_counts |
布尔 | 会话（超级用户） | on |
— | |
| 收集数据库活动累计统计。 | 现存 | ||||
track_functions |
枚举 | 会话（超级用户） | none |
— | |
| 收集函数调用次数与耗时统计。 | 现存 | ||||
track_io_timing |
布尔 | 会话（超级用户） | off |
— | |
| 收集数据库 I/O 等待计时。 | 现存 | ||||
track_wal_io_timing |
布尔 | 会话（超级用户） | off |
— | |
| 收集 WAL I/O 等待计时。 | 现存 | ||||
| 查询和索引统计收集器 1 | |||||
stats_temp_directory |
字符串 | 重载生效 | pg_stat_tmp |
— | |
| 设置旧统计收集器写临时统计文件的目录。 | 于 15 移除 | ||||
| 统计监控 5 | |||||
compute_query_id |
枚举 | 会话（超级用户） | auto |
— | |
| 启用 PostgreSQL 内核计算查询标识符。 | 现存 | ||||
log_executor_stats |
布尔 | 会话（超级用户） | off |
— | |
| 把执行器性能统计写入服务器日志。 | 现存 | ||||
log_parser_stats |
布尔 | 会话（超级用户） | off |
— | |
| 把解析器性能统计写入服务器日志。 | 现存 | ||||
log_planner_stats |
布尔 | 会话（超级用户） | off |
— | |
| 把规划器性能统计写入服务器日志。 | 现存 | ||||
log_statement_stats |
布尔 | 会话（超级用户） | off |
— | |
| 把语句累计性能统计写入服务器日志。 | 现存 | ||||
| 自动清理 21 | |||||
autovacuum |
布尔 | 重载生效 | on |
— | |
| 控制 PostgreSQL 是否运行自动清理启动器。 | 现存 | ||||
autovacuum_analyze_scale_factor |
浮点 | 重载生效 | 0.1 |
— | |
| 以 reltuples 的比例设置触发 ANALYZE 前的元组插入、更新或删除数量。 | 现存 | ||||
autovacuum_analyze_score_weight |
浮点 | 重载生效 | 1 |
— | |
| 设置 autovacuum 优先级中 ANALYZE 得分的缩放系数。 | 现存 | ||||
autovacuum_analyze_threshold |
整数 | 重载生效 | 50 |
— | |
| 设置触发 ANALYZE 前元组插入、更新或删除数量的最低阈值。 | 现存 | ||||
autovacuum_freeze_max_age |
整数 | 重启生效 | 200000000 |
— | |
| 设置为防止事务 ID 回卷而强制自动清理表的年龄。 | 现存 | ||||
autovacuum_freeze_score_weight |
浮点 | 重载生效 | 1 |
— | |
| 设置 autovacuum 优先级中事务 ID 冻结得分的缩放系数。 | 现存 | ||||
autovacuum_max_parallel_workers |
整数 | 重载生效 | 0 |
— | |
| 设置单个 autovacuum worker 可使用的最大并行 worker 数。 | 现存 | ||||
autovacuum_max_workers |
整数 | 重载生效 | 3 |
183 次 | |
| 限制可同时运行的 autovacuum worker 进程数量。 | 现存 | ||||
autovacuum_multixact_freeze_max_age |
整数 | 重启生效 | 400000000 |
— | |
| 设置为防止 MultiXact 回卷而强制自动清理表的 MultiXact 年龄。 | 现存 | ||||
autovacuum_multixact_freeze_score_weight |
浮点 | 重载生效 | 1 |
— | |
| 设置 autovacuum 优先级中 MultiXact 冻结得分的缩放系数。 | 现存 | ||||
autovacuum_naptime |
整数 | 重载生效 | 1 min |
— | |
| 设置两轮 autovacuum 扫描之间的休眠时间。 | 现存 | ||||
autovacuum_vacuum_cost_delay |
浮点 | 重载生效 | 2 ms |
121 次 | |
| 设置 autovacuum 的清理成本延迟（毫秒）。 | 现存 | ||||
autovacuum_vacuum_cost_limit |
整数 | 重载生效 | -1 |
— | |
| 设置 autovacuum 休眠前可用的清理成本额度。 | 现存 | ||||
autovacuum_vacuum_insert_scale_factor |
浮点 | 重载生效 | 0.2 |
— | |
| 以 reltuples 的比例设置触发 VACUUM 前的插入元组数量。 | 现存 | ||||
autovacuum_vacuum_insert_score_weight |
浮点 | 重载生效 | 1 |
— | |
| 设置 autovacuum 优先级中仅插入清理得分的缩放系数。 | 现存 | ||||
autovacuum_vacuum_insert_threshold |
整数 | 重载生效 | 1000 |
— | |
| 设置触发 VACUUM 前插入元组数量的最低阈值。 | 现存 | ||||
autovacuum_vacuum_max_threshold |
整数 | 重载生效 | 100000000 |
— | |
| 设置触发 VACUUM 前更新或删除元组数量的最高阈值。 | 现存 | ||||
autovacuum_vacuum_scale_factor |
浮点 | 重载生效 | 0.2 |
— | |
| 把表大小的一定比例加入触发 VACUUM 的元组变更阈值。 | 现存 | ||||
autovacuum_vacuum_score_weight |
浮点 | 重载生效 | 1 |
— | |
| 设置 autovacuum 优先级中普通 VACUUM 得分的缩放系数。 | 现存 | ||||
autovacuum_vacuum_threshold |
整数 | 重载生效 | 50 |
— | |
| 设置触发 VACUUM 前更新或删除元组数量的最低阈值。 | 现存 | ||||
autovacuum_worker_slots |
整数 | 重启生效 | 16 |
— | |
| 设置为 autovacuum worker 分配的后端槽位数量。 | 现存 | ||||
| 基于代价的清理延迟 5 | |||||
vacuum_cost_delay |
浮点 | 会话 | 0 ms |
121 次 | |
| 设置清理成本延迟（毫秒）。 | 现存 | ||||
vacuum_cost_limit |
整数 | 会话 | 200 |
— | |
| 设置清理进程休眠前可用的成本额度。 | 现存 | ||||
vacuum_cost_page_dirty |
整数 | 会话 | 20 |
— | |
| 设置 VACUUM 弄脏一个页面的成本。 | 现存 | ||||
vacuum_cost_page_hit |
整数 | 会话 | 1 |
— | |
| 设置 VACUUM 访问缓冲区缓存命中页面的成本。 | 现存 | ||||
vacuum_cost_page_miss |
整数 | 会话 | 2 |
141 次 | |
| 设置 VACUUM 访问缓冲区缓存未命中页面的成本。 | 现存 | ||||
| 默认行为 1 | |||||
vacuum_truncate |
布尔 | 会话 | on |
— | |
| 允许 VACUUM 截断表尾的空页面。 | 现存 | ||||
| 冻结 7 | |||||
vacuum_failsafe_age |
整数 | 会话 | 1600000000 |
— | |
| 设置 VACUUM 为避免事务 ID 回卷停机而进入保护模式的年龄。 | 现存 | ||||
vacuum_freeze_min_age |
整数 | 会话 | 50000000 |
— | |
| 设置 VACUUM 冻结表行所需的最小年龄。 | 现存 | ||||
vacuum_freeze_table_age |
整数 | 会话 | 150000000 |
— | |
| 设置 VACUUM 为冻结元组而扫描整张表的年龄。 | 现存 | ||||
vacuum_max_eager_freeze_failure_rate |
浮点 | 会话 | 0.03 |
— | |
| 设置 VACUUM 在关闭积极冻结扫描前，允许扫描但未能冻结的页面比例。 | 现存 | ||||
vacuum_multixact_failsafe_age |
整数 | 会话 | 1600000000 |
— | |
| 设置 VACUUM 为避免 MultiXact 回卷停机而进入保护模式的年龄。 | 现存 | ||||
vacuum_multixact_freeze_min_age |
整数 | 会话 | 5000000 |
— | |
| 设置 VACUUM 冻结表行中 MultiXactId 所需的最小年龄。 | 现存 | ||||
vacuum_multixact_freeze_table_age |
整数 | 会话 | 150000000 |
— | |
| 设置 VACUUM 为冻结 MultiXact 而扫描整张表的年龄。 | 现存 | ||||
| 语句行为 28 | |||||
bytea_output |
枚举 | 会话 | hex |
— | |
| 设置 bytea 的输出格式。 | 现存 | ||||
check_function_bodies |
布尔 | 会话 | on |
— | |
| 在 CREATE FUNCTION 和 CREATE PROCEDURE 时检查例程体。 | 现存 | ||||
client_min_messages |
枚举 | 会话 | notice |
— | |
| 设置发送给客户端的消息级别。 | 现存 | ||||
createrole_self_grant |
字符串 | 会话 | 空字符串 |
— | |
| 设置 CREATEROLE 用户是否将新建角色自动授予自身，以及使用哪些授权选项。 | 现存 | ||||
default_table_access_method |
字符串 | 会话 | heap |
— | |
| 设置新建表默认使用的表访问方法。 | 现存 | ||||
default_tablespace |
字符串 | 会话 | 空字符串 |
— | |
| 设置创建表和索引时使用的默认表空间。 | 现存 | ||||
default_toast_compression |
枚举 | 会话 | pglz |
191 次 | |
| 设置可压缩值默认使用的压缩方法。 | 现存 | ||||
default_transaction_deferrable |
布尔 | 会话 | off |
— | |
| 设置新事务默认是否可延迟。 | 现存 | ||||
default_transaction_isolation |
枚举 | 会话 | read committed |
— | |
| 设置每个新事务的默认隔离级别。 | 现存 | ||||
default_transaction_read_only |
布尔 | 会话 | off |
— | |
| 设置新事务默认是否只读。 | 现存 | ||||
event_triggers |
布尔 | 会话（超级用户） | on |
— | |
| 启用事件触发器。 | 现存 | ||||
gin_pending_list_limit |
整数 | 会话 | 4 MiB |
— | |
| 设置 GIN 索引待处理列表的最大大小。 | 现存 | ||||
idle_in_transaction_session_timeout |
整数 | 会话 | 0 ms |
— | |
| 设置事务内两次查询之间允许空闲的最长时间。 | 现存 | ||||
idle_session_timeout |
整数 | 会话 | 0 ms |
— | |
| 设置不在事务中时两次查询之间允许空闲的最长时间。 | 现存 | ||||
lock_timeout |
整数 | 会话 | 0 ms |
— | |
| 设置每次等待锁所允许的最长时间。 | 现存 | ||||
restrict_nonsystem_relation_kind |
字符串 | 会话 | 空字符串 |
— | |
| 禁止访问指定类别的非系统关系。 | 现存 | ||||
row_security |
布尔 | 会话 | on |
— | |
| 启用行级安全。 | 现存 | ||||
search_path |
字符串 | 会话 | "$user", public |
9.51 次 | |
| 设置解析未限定名称时的模式搜索顺序。 | 现存 | ||||
session_replication_role |
枚举 | 会话（超级用户） | origin |
— | |
| 设置当前会话对触发器和重写规则的处理方式。 | 现存 | ||||
statement_timeout |
整数 | 会话 | 0 ms |
— | |
| 设置单条语句允许执行的最长时间。 | 现存 | ||||
temp_tablespaces |
字符串 | 会话 | 空字符串 |
— | |
| 设置临时表和排序临时文件使用的表空间。 | 现存 | ||||
transaction_deferrable |
布尔 | 会话 | off |
— | |
| 设置当前事务是否可延迟，供只读可串行化事务安全启动。 | 现存 | ||||
transaction_isolation |
枚举 | 会话 | read committed |
122 次 | |
| 设置当前事务的隔离级别。 | 现存 | ||||
transaction_read_only |
布尔 | 会话 | off |
— | |
| 设置当前事务是否只读。 | 现存 | ||||
transaction_timeout |
整数 | 会话 | 0 ms |
— | |
| 设置会话中任一非预备事务允许持续的最长时间。 | 现存 | ||||
vacuum_cleanup_index_scale_factor |
浮点 | 会话 | 0.1 |
— | |
| 设置触发索引清理前允许新增元组数占 reltuples 的比例。 | 于 14 移除 | ||||
xmlbinary |
枚举 | 会话 | base64 |
— | |
| 设置二进制值在 XML 中的编码方式。 | 现存 | ||||
xmloption |
枚举 | 会话 | content |
— | |
| 设置隐式解析和序列化 XML 数据时将其视为文档还是内容片段。 | 现存 | ||||
| 区域和格式化 12 | |||||
client_encoding |
字符串 | 会话 | SQL_ASCII |
— | |
| 设置客户端字符集编码。 | 现存 | ||||
DateStyle |
字符串 | 会话 | ISO, MDY |
— | |
| 设置日期和时间值的显示格式。 | 现存 | ||||
default_text_search_config |
字符串 | 会话 | pg_catalog.simple |
— | |
| 设置默认的文本搜索配置。 | 现存 | ||||
extra_float_digits |
整数 | 会话 | 1 |
121 次 | |
| 设置浮点值文本输出所使用的数字位数。 | 现存 | ||||
icu_validation_level |
枚举 | 会话 | warning |
— | |
| 设置报告无效 ICU 区域设置字符串所用的消息级别。 | 现存 | ||||
IntervalStyle |
枚举 | 会话 | postgres |
— | |
| 设置 interval 值的显示格式。 | 现存 | ||||
lc_messages |
字符串 | 会话（超级用户） | 空字符串 |
— | |
| 设置显示消息所使用的语言。 | 现存 | ||||
lc_monetary |
字符串 | 会话 | C |
— | |
| 设置格式化货币金额所使用的区域设置。 | 现存 | ||||
lc_numeric |
字符串 | 会话 | C |
— | |
| 设置格式化数字所使用的区域设置。 | 现存 | ||||
lc_time |
字符串 | 会话 | C |
— | |
| 设置格式化日期和时间所使用的区域设置。 | 现存 | ||||
TimeZone |
字符串 | 会话 | GMT |
9.22 次 | |
| 设置用于显示和解释时间戳的时区。 | 现存 | ||||
timezone_abbreviations |
字符串 | 会话 | 未设置 |
9.11 次 | |
| 选择时区缩写定义文件。 | 现存 | ||||
| 共享库预载入 4 | |||||
jit_provider |
字符串 | 重启生效 | llvmjit |
— | |
| 设置要使用的 JIT 提供程序。 | 现存 | ||||
local_preload_libraries |
字符串 | 会话 | 空字符串 |
9.51 次 | |
| 列出每个后端可由非特权用户预加载的共享库。 | 现存 | ||||
session_preload_libraries |
字符串 | 会话（超级用户） | 空字符串 |
— | |
| 列出每个后端在会话开始时预加载的共享库。 | 现存 | ||||
shared_preload_libraries |
字符串 | 重启生效 | 空字符串 |
— | |
| 列出服务器启动时预加载的共享库。 | 现存 | ||||
| 其他默认值 3 | |||||
dynamic_library_path |
字符串 | 会话（超级用户） | $libdir |
— | |
| 设置动态可加载模块的搜索路径。 | 现存 | ||||
extension_control_path |
字符串 | 会话（超级用户） | $system |
— | |
| 设置扩展控制文件的搜索路径。 | 现存 | ||||
gin_fuzzy_search_limit |
整数 | 会话 | 0 |
— | |
| 设置 GIN 精确搜索允许返回的最大结果数。 | 现存 | ||||
deadlock_timeout |
整数 | 会话（超级用户） | 1 s |
9.22 次 | |
| 设置等待锁多久后开始检查死锁。 | 现存 | ||||
max_locks_per_transaction |
整数 | 重启生效 | 64 |
191 次 | |
| 设置每个事务的锁数量上限。 | 现存 | ||||
max_pred_locks_per_page |
整数 | 重载生效 | 2 |
— | |
| 设置每页可保留的元组级谓词锁最大数量。 | 现存 | ||||
max_pred_locks_per_relation |
整数 | 重载生效 | -2 |
— | |
| 设置每个关系可保留的页级和元组级谓词锁最大数量。 | 现存 | ||||
max_pred_locks_per_transaction |
整数 | 重启生效 | 64 |
— | |
| 设置每个事务的谓词锁最大数量。 | 现存 | ||||
| 以前的 PostgreSQL 版本 10 | |||||
array_nulls |
布尔 | 会话 | on |
— | |
| 允许在数组输入中使用 NULL 元素。 | 现存 | ||||
backslash_quote |
枚举 | 会话 | safe_encoding |
— | |
| 设置字符串字面量中是否允许使用反斜杠转义的单引号（\'）。 | 现存 | ||||
default_with_oids |
布尔 | 会话 | off |
— | |
| 默认创建带 OID 的新表。 | 于 12 移除 | ||||
escape_string_warning |
布尔 | 会话 | on |
— | |
| 当普通字符串字面量含反斜杠转义时发出警告。 | 于 19 移除 | ||||
lo_compat_privileges |
布尔 | 会话（超级用户） | off |
— | |
| 启用大对象权限检查的向后兼容模式。 | 现存 | ||||
operator_precedence_warning |
布尔 | 会话 | off |
— | |
| 对自 PostgreSQL 9.4 起含义发生变化的表达式发出警告。 | 于 14 移除 | ||||
quote_all_identifiers |
布尔 | 会话 | off |
— | |
| 生成 SQL 片段时引用所有标识符。 | 现存 | ||||
sql_inheritance |
布尔 | 会话 | on |
— | |
| 让多种 SQL 命令默认包含继承子表。 | 于 10 移除 | ||||
standard_conforming_strings |
布尔 | 会话 | on |
9.11 次 | |
| 使普通单引号字符串中的反斜杠按字面处理。 | 现存 | ||||
synchronize_seqscans |
布尔 | 会话 | on |
— | |
| 启用同步顺序扫描。 | 现存 | ||||
| 其他平台和客户端 2 | |||||
allow_alter_system |
布尔 | 重载生效 | on |
— | |
| 允许执行 ALTER SYSTEM 命令。 | 现存 | ||||
transform_null_equals |
布尔 | 会话 | off |
— | |
| 将 expr = NULL 视为 expr IS NULL。 | 现存 | ||||
data_sync_retry |
布尔 | 重启生效 | off |
— | |
| 设置数据文件同步失败后是否继续运行。 | 现存 | ||||
exit_on_error |
布尔 | 会话 | off |
— | |
| 发生任何错误后终止会话。 | 现存 | ||||
recovery_init_sync_method |
枚举 | 重载生效 | fsync |
— | |
| 设置崩溃恢复前同步数据目录的方法。 | 现存 | ||||
restart_after_crash |
布尔 | 重载生效 | on |
— | |
| 后端崩溃后重新初始化服务器。 | 现存 | ||||
block_size |
整数 | 内部 | 8192 |
— | |
| 显示磁盘页块大小。 | 现存 | ||||
data_checksums |
布尔 | 内部 | off |
191 次 | |
| 显示该集群是否启用了数据校验和。 | 现存 | ||||
data_directory_mode |
整数 | 内部 | 448 |
— | |
| 显示数据目录的权限模式。 | 现存 | ||||
debug_assertions |
布尔 | 内部 | off |
9.51 次 | |
| 显示运行中的服务器是否启用了断言检查。 | 现存 | ||||
debug_exec_backend |
布尔 | 内部 | off |
— | |
| 显示运行中的服务器是否启用了 EXEC_BACKEND 构建选项。 | 现存 | ||||
effective_wal_level |
枚举 | 内部 | replica |
— | |
| 显示系统当前实际生效的 WAL 级别。 | 现存 | ||||
huge_pages_status |
枚举 | 内部 | unknown |
— | |
| 显示大页的使用状态。 | 现存 | ||||
in_hot_standby |
布尔 | 内部 | off |
— | |
| 显示当前是否处于 hot standby 状态。 | 现存 | ||||
integer_datetimes |
布尔 | 内部 | on |
— | |
| 显示日期时间是否采用整数表示。 | 现存 | ||||
lc_collate |
字符串 | 内部 | C |
— | |
| 显示排序规则所使用的区域设置。 | 于 16 移除 | ||||
lc_ctype |
字符串 | 内部 | C |
— | |
| 显示字符分类与大小写转换所使用的区域设置。 | 于 16 移除 | ||||
max_function_args |
整数 | 内部 | 100 |
— | |
| 显示函数参数数量上限。 | 现存 | ||||
max_identifier_length |
整数 | 内部 | 63 |
— | |
| 显示标识符长度上限。 | 现存 | ||||
max_index_keys |
整数 | 内部 | 32 |
— | |
| 显示索引键数量上限。 | 现存 | ||||
num_os_semaphores |
整数 | 内部 | 0 |
— | |
| 显示服务器所需的操作系统信号量数量。 | 现存 | ||||
segment_size |
整数 | 内部 | 1 GiB (131072 × 8kB) |
— | |
| 显示每个磁盘文件所含的页数。 | 现存 | ||||
server_encoding |
字符串 | 内部 | SQL_ASCII |
— | |
| 显示服务器（数据库）字符集编码。 | 现存 | ||||
server_version |
字符串 | 内部 | 18.6 (Debian 18.6-1.pgdg13+2) |
1916 次 | |
| 显示服务器版本。 | 现存 | ||||
server_version_num |
整数 | 内部 | 180006 |
1916 次 | |
| 以整数形式显示服务器版本。 | 现存 | ||||
shared_memory_size |
整数 | 内部 | 0 B |
— | |
| 显示服务器主共享内存区的大小（向上取整到 MB）。 | 现存 | ||||
shared_memory_size_in_huge_pages |
整数 | 内部 | -1 |
— | |
| 显示主共享内存区所需的大页数量。 | 现存 | ||||
ssl_library |
字符串 | 内部 | OpenSSL |
— | |
| 显示 SSL 库的名称。 | 现存 | ||||
wal_block_size |
整数 | 内部 | 8192 |
— | |
| 显示预写日志块大小。 | 现存 | ||||
wal_segment_size |
整数 | 内部 | 16 MiB |
111 次 | |
| 显示预写日志段文件大小。 | 现存 | ||||
custom_variable_classes |
字符串 | 重载生效 | 未设置 |
— | |
| 设置已知自定义变量类别的列表。 | 于 9.2 移除 | ||||
allow_in_place_tablespaces |
布尔 | 会话（超级用户） | off |
— | |
| 允许在 pg_tblspc 内直接创建 tablespace，用于测试。 | 现存 | ||||
allow_system_table_mods |
布尔 | 会话（超级用户） | off |
131 次 | |
| 允许修改系统表的结构。 | 现存 | ||||
backtrace_functions |
字符串 | 会话（超级用户） | 空字符串 |
— | |
| 当指定函数中发生错误时记录调用栈。 | 现存 | ||||
debug_discard_caches |
整数 | 会话（超级用户） | 0 |
— | |
| 为调试而激进地使系统目录缓存失效。 | 现存 | ||||
debug_io_direct |
字符串 | 重启生效 | 空字符串 |
— | |
| 为指定文件访问使用直接 I/O。 | 现存 | ||||
debug_logical_replication_streaming |
枚举 | 会话 | buffered |
— | |
| 强制大型事务立即流式发送或序列化变更。 | 现存 | ||||
debug_parallel_query |
枚举 | 会话 | off |
— | |
| 为测试而强制规划器使用并行查询节点。 | 现存 | ||||
force_parallel_mode |
枚举 | 会话 | off |
— | |
| 强制使用并行查询设施。 | 于 16 移除 | ||||
ignore_checksum_failure |
布尔 | 会话（超级用户） | off |
— | |
| 校验和失败后仍继续处理。 | 现存 | ||||
ignore_invalid_pages |
布尔 | 重启生效 | off |
— | |
| 恢复遇到无效页面引用后仍继续。 | 现存 | ||||
ignore_system_indexes |
布尔 | 连接时 | off |
— | |
| 读取系统表时忽略系统索引。 | 现存 | ||||
jit_debugging_support |
布尔 | 连接时（超级用户） | off |
— | |
| 向调试器注册 JIT 生成的函数。 | 现存 | ||||
jit_dump_bitcode |
布尔 | 会话（超级用户） | off |
— | |
| 将 LLVM 位码写盘以便调试 JIT。 | 现存 | ||||
jit_expressions |
布尔 | 会话 | on |
— | |
| 允许 JIT 编译表达式。 | 现存 | ||||
jit_profiling_support |
布尔 | 连接时（超级用户） | off |
— | |
| 向 perf 分析器注册 JIT 生成的函数。 | 现存 | ||||
jit_tuple_deforming |
布尔 | 会话 | on |
— | |
| 允许 JIT 编译元组拆解。 | 现存 | ||||
post_auth_delay |
整数 | 连接时 | 0 s |
— | |
| 设置连接认证完成后的调试等待时间。 | 现存 | ||||
pre_auth_delay |
整数 | 重载生效 | 0 s |
— | |
| 设置连接认证开始前的调试等待时间。 | 现存 | ||||
remove_temp_files_after_crash |
布尔 | 重载生效 | on |
— | |
| 控制后端崩溃后是否删除临时文件。 | 现存 | ||||
send_abort_for_crash |
布尔 | 重载生效 | off |
— | |
| 后端崩溃后向其他子进程发送 SIGABRT 而非 SIGQUIT。 | 现存 | ||||
send_abort_for_kill |
布尔 | 重载生效 | off |
— | |
| 终止卡住的子进程时发送 SIGABRT 而非 SIGKILL。 | 现存 | ||||
trace_connection_negotiation |
布尔 | 重启生效 | off |
— | |
| 记录认证前连接握手的详细信息。 | 现存 | ||||
trace_notify |
布尔 | 会话 | off |
— | |
| 为 LISTEN 和 NOTIFY 生成调试输出。 | 现存 | ||||
trace_recovery_messages |
枚举 | 重载生效 | log |
— | |
| 控制恢复相关调试消息的日志级别。 | 于 17 移除 | ||||
trace_sort |
布尔 | 会话 | off |
— | |
| 输出排序操作的资源使用信息。 | 现存 | ||||
wal_consistency_checking |
字符串 | 会话（超级用户） | 空字符串 |
— | |
| 设置要执行 WAL 一致性检查的资源管理器。 | 现存 | ||||
zero_damaged_pages |
布尔 | 会话（超级用户） | off |
— | |
| 遇到损坏页面头时把内存中的页面清零后继续。 | 现存 | ||||
没有匹配的参数。清除筛选
库里共 449 个参数、18 个大版本、5532 份逐版本快照；相邻大版本之间记录到 80 次默认值变更与 137 处实质变化（默认值、单位、生效上下文、类型、取值范围或枚举值），28 个参数已经不在最新版本里。每行的「版本变动」是一排方格，一格一个大版本，与表头刻度逐格对齐；鼠标停在某一格上会写出它是哪一版、发生了什么。「默认值」一列取的是当前稳定版 18 的 boot_val，带单位的值换算成了可读形式；18 里不存在的参数取它最后存在的那一版。数据来自 guc.pg.center，说明的中文取自本站手册译文，没有译文的按英文原文显示。