PostgreSQL / 系统课时

理解参数生效方式

理解参数生效方式

本课解决“参数已经修改,为什么当前实例仍未生效”的问题。完成后,你能根据 pg_settings.context 判断修改权限和生效方式,并使用 pending_restart 检查是否仍需重启。

学习目标

  • 识别会话级、重载级和重启级参数
  • 使用 context 判断参数的生效条件
  • 使用 pending_restart 验证重启需求

参数上下文决定生效方式

PostgreSQL 不会用同一种方式处理全部参数。部分参数可由普通用户在会话中修改,部分只允许高权限用户修改,部分需要重载配置,还有一部分必须重启服务器。

sql
SELECT
    name,
    context,
    setting,
    unit,
    pending_restart
FROM pg_settings
WHERE name IN (
    'work_mem',
    'log_min_duration_statement',
    'shared_buffers'
)
ORDER BY name;

预期结果

text
name                       | context    | setting | unit | pending_restart
log_min_duration_statement | superuser  |  | ms   | f
shared_buffers             | postmaster |  | 8kB  | f
work_mem                   | user       |  | kB   | f

数值会因实例配置而不同。未修改需要重启的参数时,pending_restart 通常为 f。

会话级参数

context 为 user 的参数通常可由普通用户通过 SET 修改,只影响当前会话。superuser 表示只能由超级用户或具备相应参数权限的角色在会话中修改。

会话级设置优先于配置文件,因此排查参数值时要确认当前连接是否执行过 SET。断开连接并重新建立会话,是验证实例默认值的简单方法。

重载生效参数

context 为 sighup 的参数在配置文件修改后,可通过 SELECT pg_reload_conf(); 重新加载,无需停止数据库服务。许多日志和监控相关参数属于这一类。

重载成功只表示服务器接受了重新读取配置的请求,不保证每个参数都能动态应用。仍应查询 pg_settings 的当前值、来源和 pending_restart。

重启生效参数

context 为 postmaster 的参数只能在服务器启动时读取,例如 shared_buffers。修改这类参数后,即使重载成功,运行中的实例也继续使用旧值。可以用下面的查询检查所有等待重启的参数:

sql
SELECT
    name,
    setting AS current_value,
    unit,
    sourcefile
FROM pg_settings
WHERE pending_restart
ORDER BY name;

预期结果

text
name | current_value | unit | sourcefile

当结果非空时,应安排受控重启,并在重启后重新执行查询。不要仅凭配置文件内容判断生效状态。

变更验证原则

会话级参数在当前连接中用 SHOW 验证;重载级参数执行 pg_reload_conf() 后查询 pg_settings;重启级参数则在完成服务重启后再次核对。生产变更还应同步验证连接、日志和关键查询,避免只检查参数值。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解参数生效方式

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通