SQL COMMAND · 角色与权限

ALTER POLICY

更改一条行级安全策略的定义

change the definition of a row-level security policy

ALTER角色与权限引入 9.5现存至 20 devel1 次语法变更

动词: ALTER
对象: POLICY
分组: 角色与权限
引入版本: 9.5
状态: 现存
语法变更次数: 1
手册小节数: 4

本站手册 · 18 官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读，分岔表示选择，绕行表示可选，回环表示重复。方框为参数，点击带下划线的参数可展开子规则。

ALTER POLICY · 语法 2

语法概要

ALTER POLICY name ON table_name RENAME TO new_name

ALTER POLICY name ON table_name
[ TO { role_name | PUBLIC | CURRENT_ROLE | CURRENT_USER | SESSION_USER } [, ...] ]
[ USING ( using_expression ) ]
[ WITH CHECK ( check_expression ) ]

PostgreSQL 18 手册 · 查看完整参考页

描述

ALTER POLICY 更改一条现有行级安全策略的定义。请注意，ALTER POLICY 只允许修改策略适用的角色集合，以及 USING 和 WITH CHECK 表达式。若要更改策略的其他属性，例如它所适用的命令，或者它是宽松策略还是限制性策略，则必须删除该策略并重新创建。

要使用 ALTER POLICY，你必须拥有该策略所适用的表。

在 ALTER POLICY 的第二种形式中，角色列表、using_expression 和 check_expression 在被指定时会分别独立替换。省略这些子句中的任意一个时，策略中对应的部分保持不变。

参数

name: 要更改的现有策略名称。
table_name: 该策略所在表的名称（可选模式限定）。
new_name: 该策略的新名称。
role_name: 该策略适用的角色。可以一次指定多个角色。要将该策略应用于所有角色，可使用 PUBLIC。
using_expression: 该策略的 USING 表达式。详见 CREATE POLICY。
check_expression: 该策略的 WITH CHECK 表达式。详见 CREATE POLICY。

兼容性

ALTER POLICY 是 PostgreSQL 扩展。

另见

CREATE POLICY, DROP POLICY

语法演化

相邻大版本之间的差异，新的在前。版本号链接到对应快照。

PostgreSQL 14← 13语法变化

+ [ TO { role_name | PUBLIC | CURRENT_ROLE | CURRENT_USER | SESSION_USER } [, ...] ]正文更新
PostgreSQL 10← 9.6正文更新

正文更新
PostgreSQL 9.5← 9.4新增此命令

同组命令

命令	动词	对象	最近变更
ROLES & PRIVILEGES角色与权限20 条↑
`GRANT`	GRANT	—	1717 次
定义访问权限			现存
`REVOKE`	REVOKE	—	1719 次
撤销访问权限			现存
`ALTER DEFAULT PRIVILEGES`	ALTER	DEFAULT PRIVILEGES	186 次
定义默认访问权限			现存
`CREATE GROUP`	CREATE	GROUP	198 次
定义一个新的数据库角色			现存
`ALTER GROUP`	ALTER	GROUP	144 次
更改角色名称或成员资格			现存
`DROP GROUP`	DROP	GROUP	8.22 次
移除一个数据库角色			现存
`SECURITY LABEL`	SECURITY	LABEL	126 次
定义或更改应用于对象的安全标签			现存
`DROP OWNED`	DROP	OWNED	142 次
移除一个数据库角色所拥有的数据库对象			现存
`REASSIGN OWNED`	REASSIGN	OWNED	142 次
更改一个数据库角色所拥有的数据库对象的所有权			现存
`CREATE POLICY`	CREATE	POLICY	142 次
为一个表定义一条新的行级安全策略			现存
`ALTER POLICY`	ALTER	POLICY	141 次
更改一条行级安全策略的定义			现存
`DROP POLICY`	DROP	POLICY	9.61 次
从一个表中移除一条行级安全策略			现存
`CREATE ROLE`	CREATE	ROLE	177 次
定义一个新的数据库角色			现存
`ALTER ROLE`	ALTER	ROLE	1410 次
更改数据库角色			现存
`DROP ROLE`	DROP	ROLE	8.21 次
移除一个数据库角色			现存
`SET ROLE`	SET	ROLE	9.01 次
设置当前会话的当前用户标识符			现存
`SET SESSION AUTHORIZATION`	SET	SESSION AUTHORIZATION	9.02 次
设置当前会话的会话用户标识符和当前用户标识符			现存
`CREATE USER`	CREATE	USER	1912 次
定义一个新的数据库角色			现存
`ALTER USER`	ALTER	USER	1417 次
更改数据库角色			现存
`DROP USER`	DROP	USER	8.23 次
移除一个数据库角色			现存

快速链接

版本轨迹

语法铁道图 PostgreSQL 18

语法概要

描述

参数

兼容性

另见

语法演化

相关命令

同组命令