选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

ALTER DEFAULT PRIVILEGES

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

Synopsis

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
    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
    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允许设置将应用于将来创建的对象的权限。(它不影响已存在对象的权限。)目前只能更改模式、表(包括视图和外部表)、序列、函数和类型(包括域)的权限。

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

GRANT下所述,任何对象类型的默认权限通常会向对象所有者授予所有可授予的权限,也可能向PUBLIC授予一些权限。不过,可以通过使用ALTER DEFAULT PRIVILEGES更改全局默认权限来改变这种行为。

按模式指定的默认权限会添加到特定对象类型的全局默认权限中。这意味着,如果权限是全局授予的(无论是默认授予,还是根据未指定模式的先前ALTER DEFAULT PRIVILEGES命令授予),就不能按模式撤销这些权限。按模式执行REVOKE仅用于撤销先前按模式执行的GRANT的效果。

参数

target_role

当前角色所属的现有角色的名称。如果省略FOR ROLE,则假定为当前角色。

schema_name

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

role_name

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

注解

使用psql\ddp命令获取现有默认权限分配的信息。权限值的含义与GRANT下对\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