↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / 配置参数 / 开发者选项

CONFIGURATION PARAMETER开发者选项

allow_system_table_mods

允许修改系统表的结构。

Allows modifications of the structure of system tables.

布尔 会话(超级用户) 引入 9.0(基线) 现存至 20 devel 0 次默认值变更

类型
布尔bool
上下文
会话(超级用户)超级用户可在会话内用 SET 修改
默认值
off
引入版本
9.0(基线)
状态
现存

PostgreSQL 18 手册 官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

off 9.0 – 20

已记录的默认值在 PostgreSQL 9.0–20 之间未变。带单位的取值换算成了可读形式,原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18 手册 · 19.17 开发人员选项 本站手册 官方原文

本版译文与 PostgreSQL 15 完全一致,下面就是同一段文字。

允许修改系统表的结构以及对系统表进行某些其他风险操作。否则,即使超级用户也不允许执行这些操作。不明智地使用此设置可能导致无法挽回的数据丢失或严重损坏数据库系统。只有超级用户和具有适当SET权限的用户才能更改此设置。

机制详解

allow_system_table_mods 解除系统目录结构修改保护,并允许其他通常禁止的目录操作;仅有超级用户身份通常也不能执行这些动作。

目录定义与 PostgreSQL 代码、缓存描述、bootstrap 数据、WAL 和升级假设紧密耦合;表面合法的 ALTER 也可能造成不可逆损坏或数据丢失。

该参数用于 PostgreSQL 开发、bootstrap 与严格受控工具,不是受支持的扩展机制;扩展应使用公开目录与 hook 接口。其 superuser 上下文允许获授权会话修改,无需重启服务器。

调优建议

按典型负载给出的取值思路,不是放之四海皆准的配方:实际取值要看数据量、并发度与硬件。

  • OLTP在线事务处理

    绝不能用 allow_system_table_mods 做性能调优。只限 PostgreSQL 开发或有已验证备份与精确回滚路径的可丢弃维护流程。

  • OLAP分析与批处理

    负载类型不会降低 allow_system_table_mods 的目录损坏风险;分析系统同样必须关闭。

  • 小规格低配实例与开发机

    保持 allow_system_table_mods=off。没有预备环境不等于可以在唯一数据副本上实验。

常见问题

  • 限时诊断或恢复任务结束后仍让 allow_system_table_mods 保持启用。
  • 在生产数据的唯一副本上进行实验。
  • 低估日志、core、临时文件、WAL、CPU 或连接名额放大。
  • 把服务器能启动或查询能完成误当作数据与行为正确的证明。

演化历史

相邻两个大版本之间的差异,新的在前。版本号链到该版的快照。

  1. PostgreSQL 20 ← 19 沿用 19

    事实沿用 19

  2. PostgreSQL 13 ← 12 属性变更

    上下文 重启生效 会话(超级用户)

逐版本快照

每个收录版本里的 7 项事实,与上一个存在的版本不同的格子带底色。版本号链到该版。

版本 默认值单位上下文类型最小值最大值枚举值
9.0 off — 重启生效 布尔 — — —
9.1 off — 重启生效 布尔 — — —
9.2 off — 重启生效 布尔 — — —
9.3 off — 重启生效 布尔 — — —
9.4 off — 重启生效 布尔 — — —
9.5 off — 重启生效 布尔 — — —
9.6 off — 重启生效 布尔 — — —
10 off — 重启生效 布尔 — — —
11 off — 重启生效 布尔 — — —
12 off — 重启生效 布尔 — — —
13 off — 会话(超级用户) 布尔 — — —
14 off — 会话(超级用户) 布尔 — — —
15 off — 会话(超级用户) 布尔 — — —
16 off — 会话(超级用户) 布尔 — — —
17 off — 会话(超级用户) 布尔 — — —
18 off — 会话(超级用户) 布尔 — — —
19 off — 会话(超级用户) 布尔 — — —
20 沿用 off — 会话(超级用户) 布尔 — — —

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Developer Options 开发者选项 27 个 ↗
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 —
遇到损坏页面头时把内存中的页面清零后继续。 现存