↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0
历史版本。 PostgreSQL 12 已结束支持。 2024-11-21. 请参阅 当前版本手册.

ALTER DEFAULT PRIVILEGES

ALTER DEFAULT PRIVILEGES — 定义默认访问权限

大纲

ALTER DEFAULT PRIVILEGES
    [ FOR { ROLE | USER } target_role [, ...] ]
    [ IN SCHEMA schema_name [, ...] ]
    abbreviated_grant_or_revoke

其中abbreviated_grant_or_revoke为以下之一:

GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER }
    [, ...] | ALL [ PRIVILEGES ] }
    ON TABLES
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { { USAGE | SELECT | UPDATE }
    [, ...] | ALL [ PRIVILEGES ] }
    ON SEQUENCES
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { EXECUTE | ALL [ PRIVILEGES ] }
    ON { FUNCTIONS | ROUTINES }
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { USAGE | ALL [ PRIVILEGES ] }
    ON TYPES
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { { USAGE | CREATE }
    [, ...] | ALL [ PRIVILEGES ] }
    ON SCHEMAS
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

REVOKE [ GRANT OPTION FOR ]
    { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER }
    [, ...] | ALL [ PRIVILEGES ] }
    ON TABLES
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ]

REVOKE [ GRANT OPTION FOR ]
    { { USAGE | SELECT | UPDATE }
    [, ...] | ALL [ PRIVILEGES ] }
    ON SEQUENCES
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ]

REVOKE [ GRANT OPTION FOR ]
    { EXECUTE | ALL [ PRIVILEGES ] }
    ON { FUNCTIONS | ROUTINES }
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ]

REVOKE [ GRANT OPTION FOR ]
    { USAGE | ALL [ PRIVILEGES ] }
    ON TYPES
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ]

REVOKE [ GRANT OPTION FOR ]
    { { USAGE | CREATE }
    [, ...] | ALL [ PRIVILEGES ] }
    ON SCHEMAS
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ]

描述

ALTER DEFAULT PRIVILEGES 允许设置将应用于将来创建对象的权限。(它不影响已存在对象的权限。)目前只能更改模式、表(包括视图和外部表)、序列、函数和类型(包括域)的权限。对于此命令,函数包括聚合函数和过程。FUNCTIONS 和 ROUTINES 在此命令中等价。(今后更推荐使用 ROUTINES,作为函数和过程合称时的标准术语。在 PostgreSQL 早期版本中,只允许使用 FUNCTIONS 一词。不能分别为函数和过程设置默认权限。)

只能更改将由自己或自己所属的角色创建的对象的默认权限。这些权限可以全局设置(即,适用于当前数据库中创建的所有对象),也可以只针对指定模式中创建的对象设置。

如第 5.7 节中所述,任何对象类型的默认权限通常都会将所有可授予的权限授予对象拥有者,并且也可能向 PUBLIC 授予某些权限。不过,这种行为可以通过 ALTER DEFAULT PRIVILEGES 修改全局默认权限来改变。

按模式指定的默认权限会叠加到该对象类型的全局默认权限之上。这意味着,如果某项权限是在全局范围内授予的(无论是默认授予,还是根据此前未指定模式的 ALTER DEFAULT PRIVILEGES 命令授予的),就不能按模式将其撤销。按模式执行的 REVOKE 只适用于抵消此前按模式执行的 GRANT 所产生的效果。

参数

target_role

当前角色所属的现有角色的名称。默认访问权限不会被继承,因此成员角色必须使用 SET ROLE 访问这些权限,或者必须为每个成员角色运行 ALTER DEFAULT PRIVILEGES。如果省略 FOR ROLE,则假定为当前角色。

schema_name

一个现有模式的名称。如果指定,将修改以后在该模式中创建的对象的默认权限。如果省略 IN SCHEMA,则修改全局默认权限。在为模式设置权限时,不允许使用 IN SCHEMA,因为模式不能嵌套。

role_name

要为其授予或撤销权限的现有角色的名称。此参数以及 abbreviated_grant_or_revoke 中的所有其他参数,均按 GRANT 或 REVOKE 中的描述工作,只不过这里设置的是整类对象的权限,而不是特定的具名对象。

注解

使用 psql 的\ddp 命令,可以获取现有默认权限分配的信息。权限显示的含义与第 5.7 节中针对\dp 的说明相同。

如果你希望删除一个其默认权限已被修改的角色,则必须先撤销对其默认权限所做的更改,或者使用 DROP OWNED BY 去除该角色的默认权限条目。

示例

为你后续在模式 myschema 中创建的所有表(以及视图)向所有人授予 SELECT 权限,并且也允许角色 webuser 对它们执行 INSERT:

ALTER DEFAULT PRIVILEGES IN SCHEMA myschema GRANT SELECT ON TABLES TO PUBLIC;
ALTER DEFAULT PRIVILEGES IN SCHEMA myschema GRANT INSERT ON TABLES TO webuser;

撤销上述操作,使后续创建的表不再拥有任何超出正常情况的权限:

ALTER DEFAULT PRIVILEGES IN SCHEMA myschema REVOKE SELECT ON TABLES FROM PUBLIC;
ALTER DEFAULT PRIVILEGES IN SCHEMA myschema REVOKE INSERT ON TABLES FROM webuser;

移除通常会在函数上授予的公共 EXECUTE 权限,使后续由角色 admin 创建的所有函数不再自动具有该权限:

ALTER DEFAULT PRIVILEGES FOR ROLE admin REVOKE EXECUTE ON FUNCTIONS FROM PUBLIC;

但请注意,你不能用仅限单个模式的命令实现这一效果。下面这条命令不会产生作用,除非它是在撤销与之对应的 GRANT:

ALTER DEFAULT PRIVILEGES IN SCHEMA public REVOKE EXECUTE ON FUNCTIONS FROM PUBLIC;

这是因为按模式设置的默认权限只能向全局设置增加权限,不能移除由全局设置授予的权限。

兼容性

在 SQL 标准中没有 ALTER DEFAULT PRIVILEGES 语句。

另见

GRANT, REVOKE

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.