REVOKE

功能描述

REVOKE用于撤销一个或多个角色的权限。

注意事项

非对象所有者试图在对象上REVOKE权限，命令按照以下规则执行：

  • 如果授权用户没有该对象上的权限，则命令立即失败。
  • 如果授权用户有部分权限，则只撤销那些有授权选项的权限。
  • 如果授权用户没有授权选项，REVOKE ALL PRIVILEGES形式将发出一个错误信息，而对于其他形式的命令而言，如果是命令中指定名称的权限没有相应的授权选项，该命令将发出一个警告。
  • 不允许对表分区进行REVOKE操作，对分区表进行REVOKE操作会引起告警。

语法格式

  • 回收指定表或视图上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | ALTER | DROP | COMMENT | INDEX | VACUUM }[, ...] 
    3.     | ALL [ PRIVILEGES ] }
    4.     ON { [ TABLE ] table_name [, ...]
    5.        | ALL TABLES IN SCHEMA schema_name [, ...] }
    6.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    7.     [ CASCADE | RESTRICT ];

  • 回收表上指定字段权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { {{ SELECT | INSERT | UPDATE | REFERENCES | COMMENT } ( column_name [, ...] )}[, ...] 
    3.     | ALL [ PRIVILEGES ] ( column_name [, ...] ) }
    4.     ON [ TABLE ] table_name [, ...]
    5.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    6.     [ CASCADE | RESTRICT ];

  • 回收指定序列上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { { SELECT | UPDATE | ALTER | DROP | COMMENT }[, ...] 
    3.     | ALL [ PRIVILEGES ] }
    4.     ON { [  SEQUENCE ] sequence_name [, ...]
    5.        | ALL SEQUENCES IN SCHEMA schema_name [, ...] }
    6.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    7.     [ CASCADE | RESTRICT ];

  • 回收指定数据库上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { { CREATE | CONNECT | TEMPORARY | TEMP | ALTER | DROP | COMMENT } [, ...] 
    3.     | ALL [ PRIVILEGES ] }
    4.     ON DATABASE database_name [, ...]
    5.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    6.     [ CASCADE | RESTRICT ];

  • 回收指定域上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { USAGE | ALL [ PRIVILEGES ] }
    3.     ON DOMAIN domain_name [, ...]
    4.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    5.     [ CASCADE | RESTRICT ];

  • 回收指定客户端加密主密钥上的权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { { USAGE | DROP } [, ...] | ALL [PRIVILEGES] }
    3.     ON CLIENT_MASTER_KEYS client_master_keys_name [, ...]
    4.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    5.     [ CASCADE | RESTRICT ];

  • 回收指定列加密密钥上的权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { { USAGE | DROP } [, ...] | ALL [PRIVILEGES]}
    3.     ON COLUMN_ENCRYPTION_KEYS column_encryption_keys_name [, ...]
    4.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    5.     [ CASCADE | RESTRICT ];

  • 回收指定目录上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { { READ | WRITE | ALTER |DROP } [, ...] | ALL [ PRIVILEGES ] }
    3.     ON DIRECTORY directory_name [, ...]
    4.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    5.     [ CASCADE | RESTRICT ];

  • 回收指定外部数据源上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.    { USAGE | ALL [ PRIVILEGES ] }
    3.     ON FOREIGN DATA WRAPPER fdw_name [, ...]
    4.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    5.     [ CASCADE | RESTRICT ];

  • 回收指定外部服务器上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { { USAGE | ALTER | DROP | COMMENT } [, ...] | ALL [ PRIVILEGES ] }
    3.     ON FOREIGN SERVER server_name [, ...]
    4.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    5.     [ CASCADE | RESTRICT ];

  • 回收指定函数上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { { EXECUTE | ALTER | DROP | COMMENT } [, ...] | ALL [ PRIVILEGES ] }
    3.     ON { FUNCTION {function_name ( [ {[ argmode ] [ arg_name ] arg_type} [, ...] ] )} [, ...]
    4.        | ALL FUNCTIONS IN SCHEMA schema_name [, ...] }
    5.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    6.     [ CASCADE | RESTRICT ];

  • 回收指定过程语言上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.    { USAGE | ALL [ PRIVILEGES ] }
    3.     ON LANGUAGE lang_name [, ...]
    4.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    5.     [ CASCADE | RESTRICT ];

  • 回收指定大对象上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { { SELECT | UPDATE } [, ...] | ALL [ PRIVILEGES ] }
    3.     ON LARGE OBJECT loid [, ...]
    4.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    5.     [ CASCADE | RESTRICT ];

  • 回收指定模式上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { { CREATE | USAGE | ALTER | DROP | COMMENT } [, ...] | ALL [ PRIVILEGES ] }
    3.     ON SCHEMA schema_name [, ...]
    4.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    5.     [ CASCADE | RESTRICT ];

  • 回收指定表空间上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.     { { CREATE | ALTER | DROP | COMMENT } [, ...] | ALL [ PRIVILEGES ] }
    3.     ON TABLESPACE tablespace_name [, ...]
    4.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    5.     [ CASCADE | RESTRICT ];

  • 回收指定类型上权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.    { { USAGE | ALTER | DROP | COMMENT } [, ...] | ALL [ PRIVILEGES ] }
    3.     ON TYPE type_name [, ...]
    4.     FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    5.     [ CASCADE | RESTRICT ];

  • 回收Data Source对象上的权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.    { USAGE | ALL [PRIVILEGES] }
    3.     ON DATA SOURCE src_name [, ...]
    4.     FROM {[GROUP] role_name | PUBLIC} [, ...]
    5.    [ CASCADE | RESTRICT ];

  • 回收package对象的权限。

    1. REVOKE [ GRANT OPTION FOR ]
    2.    { { EXECUTE | ALTER | DROP | COMMENT } [, ...] | ALL [PRIVILEGES] }
    3.    ON PACKAGE package_name [, ...]
    4.    FROM {[GROUP] role_name | PUBLIC} [, ...]
    5.    [ CASCADE | RESTRICT ];

  • 按角色回收角色上的权限。

    1. REVOKE [ ADMIN OPTION FOR ]
    2.     role_name [, ...] FROM role_name [, ...]
    3.     [ CASCADE | RESTRICT ];

  • 回收角色上的sysadmin权限。

    1. REVOKE ALL { PRIVILEGES | PRIVILEGE } FROM role_name;

参数说明

关键字PUBLIC表示一个隐式定义的拥有所有角色的组。

权限类别和参数说明，请参见GRANT的参数说明。

任何特定角色拥有的特权包括直接授予该角色的特权、从该角色作为其成员的角色中得到的权限以及授予给PUBLIC的权限。因此，从PUBLIC收回SELECT特权并不一定会意味着所有角色都会失去在该对象上的SELECT特权，那些直接被授予的或者通过另一个角色被授予的角色仍然会拥有它。类似地，从一个用户收回SELECT后，如果PUBLIC仍有SELECT权限，该用户还是可以使用SELECT。

指定GRANT OPTION FOR时，只撤销对该权限授权的权力，而不撤销该权限本身。

如用户A拥有某个表的UPDATE权限，及WITH GRANT OPTION选项，同时A把这个权限赋予了用户B，则用户B持有的权限称为依赖性权限。当用户A持有的权限或者授权选项被撤销时，必须声明CASCADE，将所有依赖性权限都撤销。

一个用户只能撤销由它自己直接赋予的权限。例如，如果用户A被指定授权（WITH ADMIN OPTION）选项，且把一个权限赋予了用户B，然后用户B又赋予了用户C，则用户A不能直接将C的权限撤销。但是，用户A可以撤销用户B的授权选项，并且使用CASCADE。这样，用户C的权限就会自动被撤销。另外一个例子：如果A和B都赋予了C同样的权限，则A可以撤销他自己的授权选项，但是不能撤销B的，因此C仍然拥有该权限。

如果执行REVOKE的角色持有的权限是通过多层成员关系获得的，则具体是哪个包含的角色执行的该命令是不确定的。在这种场合下，最好的方法是使用SET ROLE成为特定角色，然后执行REVOKE，否则可能导致删除了不想删除的权限，或者是任何权限都没有删除。

示例

请参考GRANT的示例。

相关链接

GRANT