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

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

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 允许你设置将应用于未来创建对象的权限。(它不会影响已经存在的对象上已分配的权限。)权限既可以全局设置(即,对当前数据库中未来创建的所有对象生效),也可以只针对指定模式中未来创建的对象设置。

虽然你可以修改自己的默认权限,也可以修改你所属角色的默认权限,但在创建对象时,新对象的权限只受当前角色的默认权限影响,不会从当前角色所属的任何角色继承。

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

当前,只有模式、表(包括视图和外部表)、序列、函数、类型(包括域)的权限可以修改。对于此命令,函数包括聚合函数和过程。此命令中的 FUNCTIONS 和 ROUTINES 等价。(今后更推荐使用 ROUTINES,因为这是同时指代函数和过程的标准术语。在较早的 PostgreSQL 版本中,只允许使用 FUNCTIONS。无法分别为函数和过程设置默认权限。)

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

参数

target_role #

修改由 target_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

报告文档问题

阅读 上游文档. 通过 PostgreSQL 文档反馈表单.