Help Center/ GaussDB(DWS)/ SQL Syntax Reference (8.1.3.x)/ DCL Syntax/ REVOKE
Updated on 2024-09-30 GMT+08:00
View PDF

REVOKE

Function

REVOKE revokes rights from one or more roles.

Precautions

If a non-owner user of an object attempts to REVOKE rights on the object, the command is executed based on the following rules:

  • If the user has no right whatsoever on the object, the command will fail outright.
  • If some permissions are available, the command proceeds, but it revokes only those rights for which the user has grant options.
  • The REVOKE ALL PRIVILEGES forms will issue an error message if no grant options are held, while the other forms will issue a warning if grant options for any of the rights named in the command are not held.
  • Do not perform REVOKE to a table partition. Performing REVOKE to a partitioned table incurs an alarm.

Syntax

  • Revoke the permission of specified table and view. 
    1
2
3
4
5
6
7
    		 
    REVOKE [ GRANT OPTION FOR ]
    { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER | ANALYZE | ANALYSE | VACUUM | ALTER | DROP }[, ...] 
    | ALL [ PRIVILEGES ] }
    ON { [ TABLE ] table_name [, ...]
       | ALL TABLES IN SCHEMA schema_name [, ...] }
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ];
  • Revoke the permission of specified fields on the table. 
    1
2
3
4
5
6
    		 
    REVOKE [ GRANT OPTION FOR ]
    { {{ SELECT | INSERT | UPDATE | REFERENCES } ( column_name [, ...] )}[, ...] 
    | ALL [ PRIVILEGES ] ( column_name [, ...] ) }
    ON [ TABLE ] table_name [, ...]
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ];
  • Revoke the permission of a specified database. 
    1
2
3
4
5
6
    		 
    REVOKE [ GRANT OPTION FOR ]
    { { CREATE | CONNECT | TEMPORARY | TEMP } [, ...] 
    | ALL [ PRIVILEGES ] }
    ON DATABASE database_name [, ...]
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ];
  • Revoke the permission of a specified function. 
    1
2
3
4
5
6
    		 
    REVOKE [ GRANT OPTION FOR ]
    { EXECUTE | ALL [ PRIVILEGES ] }
    ON { FUNCTION {function_name ( [ {[ argmode ] [ arg_name ] arg_type} [, ...] ] )} [, ...]
       | ALL FUNCTIONS IN SCHEMA schema_name [, ...] }
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ];
  • Revoke the permission of a specified large object. 
    1
2
3
4
5
    		 
    REVOKE [ GRANT OPTION FOR ]
    { { SELECT | UPDATE } [, ...] | ALL [ PRIVILEGES ] }
    ON LARGE OBJECT loid [, ...]
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ];
  • Revoke the permission on a specified sequence. 
    1
2
3
4
5
    		 
    REVOKE [ GRANT OPTION FOR ]
    { { SELECT | UPDATE | USAGE } [, ...] | ALL [ PRIVILEGES ] }
    ON SEQUENCE sequence_name [, ...]
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ];
  • Revoke the permission of a specified schema. 
    1
2
3
4
5
    		 
    REVOKE [ GRANT OPTION FOR ]
    { { CREATE | USAGE | ALTER | DROP } [, ...] | ALL [ PRIVILEGES ] }
    ON SCHEMA schema_name [, ...]
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ];
  • Revoke the permission of a specified sub-cluster. 
    1
2
3
4
5
    		 
    REVOKE [ GRANT OPTION FOR ]
    { CREATE | USAGE | COMPUTE | ALL [ PRIVILEGES ] }
    ON NODE GROUP group_name [, ...]
    FROM { [ GROUP ] role_name | PUBLIC } [, ...]
    [ CASCADE | RESTRICT ];
  • Revoke the permission of roles based on roles. 
    1
2
3
    		 
    REVOKE [ ADMIN OPTION FOR ]
    role_name [, ...] FROM role_name [, ...]
    [ CASCADE | RESTRICT ];
  • Revoke the sysadmin permission of roles. 
    1
    		 
    REVOKE ALL { PRIVILEGES | PRIVILEGE } FROM role_name;

Parameter Description

The keyword PUBLIC indicates an implicitly defined group that contains all roles.

See Parameter Description of the GRANT command for the meaning of the privileges and related parameters.

Permissions of a role include the permissions directly granted to the role, permissions inherited from the parent role, and permissions granted to PUBLIC. Therefore, revoking the SELECT permission for an object from PUBLIC does not necessarily mean that the SELECT permission for the object has been revoked from all roles, because the SELECT permission directly granted to roles and inherited from parent roles still remains. Similarly, if the SELECT permission is revoked from a user but is not revoked from PUBLIC, the user can still run the SELECT statement.

If GRANT OPTION FOR is specified, only the grant option for the right is revoked, not the right itself.

If user A holds the UPDATE rights on a table and the WITH GRANT OPTION and has granted them to user B, the rights that user B holds are called dependent rights. If the rights or the grant option held by user A is revoked, the dependent rights still exist. Those dependent rights are also revoked if CASCADE is specified.

A user can only revoke rights that were granted directly by that user. If, for example, user A has granted a right with grant option (WITH ADMIN OPTION) to user B, and user B has in turned granted it to user C, then user A cannot revoke the right directly from C. However, user A can revoke the grant option held by user B and use CASCADE. In this manner, the rights held by user C are automatically revoked. For another example, if both user A and user B have granted the same right to C, A can revoke his own grant but not B's grant, so C will still effectively have the right.

If the role executing REVOKE holds rights indirectly via more than one role membership path, it is unspecified which containing role will be used to execute the command. In such cases, it is best practice to use SET ROLE to become the specific role you want to do the REVOKE as, and then execute REVOKE. Failure to do so may lead to deleting rights not intended to delete, or not deleting any rights at all.

Examples

Revoke all permissions of user joe: 
1
 
REVOKE ALL PRIVILEGES FROM joe;
Revoke the permissions granted in a specified schema: 
1
 
REVOKE USAGE,CREATE ON SCHEMA tpcds FROM tpcds_manager;

Revoke the CONNECT privilege from user joe.

1
 
REVOKE CONNECT FROM joe;

Revoke the membership of role admins from user joe.

1
 
REVOKE admins FROM joe;

Revoke all the privileges of user joe for the myView view.

1
 
REVOKE ALL PRIVILEGES ON myView FROM joe;

Revoke the public insert permission on the customer_t1 table.

1
 
REVOKE INSERT ON customer_t1 FROM PUBLIC;

Revoke user joe's permission for the tpcds schema.

1
 
REVOKE USAGE ON SCHEMA tpcds FROM joe;

Revoke the query permissions for r_reason_sk and r_reason_id in the tpcds.reason table from user joe.

1
 
REVOKE select (r_reason_sk, r_reason_id) ON tpcds.reason FROM joe;

Links

GRANT

Parent topic: DCL Syntax