跳转到主要内容

restrict_nonsystem_relation_kind

restrict_nonsystem_relation_kind 是 PostgreSQL 中用于禁止访问指定类别的非系统关系的参数。
说明

Fact — 官方简述译文:禁止访问指定类别的非系统关系。

身份

类型 , string
上游 pg_settings 类型
Context , user
普通用户可在运行时修改
单位 ,
原始单位
范围 ,
最后在档版本的原始上下限
枚举值 ,
非枚举类型记为 —
分类 , Client Connection Defaults / Statement Behavior
上游分类
最后 boot 值 , ""
empty string

生命周期

Fact
首次观测 PG12
在档版本 PG12–19 Beta 3
移除版本
引入提交 79c7a7e29695 — Restrict accesses to non-system views and foreign tables during pg_dump.
提交日期 2024-08-05
Discussion

默认值变迁

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

机制详解

restrict_nonsystem_relation_kind:禁止访问指定类别的非系统关系。目前支持 view 与 foreign-table;PostgreSQL 将其用作特殊会话的安全边界,而不是通用 SQL 授权机制。

restrict_nonsystem_relation_kind 属于 USER 上下文。获授权角色可在会话内修改,ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

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

调优建议

提示

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

场景 建议
OLTP 不应把 restrict_nonsystem_relation_kind 当作通用安全策略调优。除非 PostgreSQL 子系统或严格限定的维护流程明确需要,否则保持空值。
OLAP 不要用它沙箱化任意分析用户;应通过权限、模式与行级策略实施访问控制。
小规格 保持默认空值;启用关系类别禁令没有容量收益,却可能意外破坏普通查询。

Pigsty 取值

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

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

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

常见坑

  • 只在一个会话中修改 restrict_nonsystem_relation_kind,却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
  • 对可改变正确性、策略执行或名称解析的控制项授予过宽 SET 权限。
  • 池化连接交给另一个请求前,没有重置安全敏感的会话值。
  • 没有回滚计划及客户端或运维兼容测试,就全局修改 restrict_nonsystem_relation_kind。

search_path · row_security · session_replication_role · event_triggers · createrole_self_grant

参考资料