跳转到主要内容

session_replication_role

session_replication_role 定义当前会话对触发器和重写规则的处理方式。
说明

Fact — 官方简述译文:设置当前会话对触发器和重写规则的处理方式。

身份

类型 , enum
上游 pg_settings 类型
Context , superuser
超级用户可在运行时修改
单位 ,
原始单位
范围 ,
最后在档版本的原始上下限
枚举值 , origin, replica, local
非枚举类型记为 —
分类 , Client Connection Defaults / Statement Behavior
上游分类
最后 boot 值 , origin
origin

生命周期

Fact
首次观测 PG9.0(研究下界)
在档版本 PG9.0–19 Beta 3
移除版本
引入提交 不作断言:早于 PG9.0 研究边界
提交日期
Discussion

默认值变迁

PG9.0–19 Beta 3 实测 boot 默认值
版本 原始 boot_val 单位 人类可读值
PG9.0–19 Beta 3 origin origin

机制详解

session_replication_role:设置当前会话对触发器和重写规则的处理方式。replica 会抑制普通触发器和规则,包括外键检查;更改该值还会丢弃已缓存计划。

session_replication_role 属于 SUPERUSER 上下文。超级用户或获授相应 SET 权限的角色可在会话内修改,ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

由于会话状态可能在连接池中残留,角色默认值、SET 权限、RESET 行为与应用取连接钩子都是有效控制边界的一部分。

调优建议

提示

Advice。 以下建议是工作负载起点,必须用真实测量验证。

场景 建议
OLTP 不应调优 session_replication_role。只有受控复制或修复流程才可设为 replica,且必须独立保证约束并恢复 origin。
OLAP 分析会话保持 origin;抑制触发器不会加速读取,却会在会话写入时造成严重风险。
小规格 保持 origin;它不是小节点优化,并可能绕过外键。

Pigsty 取值

以下值来自固定 8 核、32 GiB、100 GiB SSD 夹具,并按 PG19 Beta 3 渲染当前 Pigsty 模板;这不表示 Pigsty 当前支持该历史或测试版本。

模板 有效值 与上游 boot 比较 源表达式
OLTP 未修改
OLAP 未修改
CRIT 未修改
TINY 未修改
注意

Advice — 待人工复核。 当前 Pigsty 模板投影事实:OLTP: PG9.0–19 Beta 3 未修改;OLAP: PG9.0–19 Beta 3 未修改;CRIT: PG9.0–19 Beta 3 未修改;TINY: PG9.0–19 Beta 3 未修改。 未发现覆盖值,因此不推断 Pigsty 专属理由。

常见坑

  • 只在一个会话中修改 session_replication_role,却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
  • 对可改变正确性、策略执行或名称解析的控制项授予过宽 SET 权限。
  • 池化连接交给另一个请求前,没有重置安全敏感的会话值。
  • 忘记 replica 模式既抑制应用触发器,也抑制外键触发器。

search_path · row_security · event_triggers · restrict_nonsystem_relation_kind · createrole_self_grant

参考资料