跳转到主要内容

createrole_self_grant

createrole_self_grant 定义 CREATEROLE 用户是否将新建角色自动授予自身,以及使用哪些授权选项。
说明

Fact — 官方简述译文:设置 CREATEROLE 用户是否将新建角色自动授予自身,以及使用哪些授权选项。

身份

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

生命周期

Fact
首次观测 PG16
在档版本 PG16–19 Beta 3
移除版本
引入提交 e5b8a4c098ad — Add new GUC createrole_self_grant.
提交日期 2023-01-10
Discussion 讨论 1

默认值变迁

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

机制详解

createrole_self_grant:设置 CREATEROLE 用户是否将新建角色自动授予自身,以及使用哪些授权选项。可选项为 set、inherit 或二者;它自动完成创建者凭 ADMIN OPTION 本可执行的授权,对超级用户没有实际影响。

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

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

调优建议

提示

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

场景 建议
OLTP 把 createrole_self_grant 当作正确性或安全控制,而非吞吐旋钮。严格限制 SET 权限,并由可信的角色或应用策略建立取值。
OLAP 若 createrole_self_grant 必须不同,使用专用分析角色,并验证导出、触发器、策略与名称解析仍保持数据正确性。
小规格 除非有文档化的修复或兼容流程,否则保持 createrole_self_grant 的安全默认值;临时变化应留痕并自动恢复。

Pigsty 取值

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

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

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

常见坑

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

search_path · row_security · session_replication_role · event_triggers · restrict_nonsystem_relation_kind

参考资料