REVOKE

Removes access privileges.

Synopsis

  1. REVOKE [GRANT OPTION FOR] { {SELECT | INSERT | UPDATE | DELETE 
  2.        | REFERENCES | TRUNCATE } [,...] | ALL [PRIVILEGES] }
  3.        ON [TABLE] <tablename> [, ...]
  4.        FROM {<rolename> | PUBLIC} [, ...]
  5.        [CASCADE | RESTRICT]
  7. REVOKE [GRANT OPTION FOR] { {USAGE | SELECT | UPDATE} [,...] 
  8.        | ALL [PRIVILEGES] }
  9.        ON SEQUENCE <sequencename> [, ...]
  10.        FROM { <rolename> | PUBLIC } [, ...]
  11.        [CASCADE | RESTRICT]
  13. REVOKE [GRANT OPTION FOR] { {CREATE | CONNECT 
  14.        | TEMPORARY | TEMP} [,...] | ALL [PRIVILEGES] }
  15.        ON DATABASE <dbname> [, ...]
  16.        FROM {<rolename> | PUBLIC} [, ...]
  17.        [CASCADE | RESTRICT]
  19. REVOKE [GRANT OPTION FOR] {EXECUTE | ALL [PRIVILEGES]}
  20.        ON FUNCTION <funcname> ( [[<argmode>] [<argname>] <argtype>
  21.                               [, ...]] ) [, ...]
  22.        FROM {<rolename> | PUBLIC} [, ...]
  23.        [CASCADE | RESTRICT]
  25. REVOKE [GRANT OPTION FOR] {USAGE | ALL [PRIVILEGES]}
  26.        ON LANGUAGE <langname> [, ...]
  27.        FROM {<rolename> | PUBLIC} [, ...]
  28.        [ CASCADE | RESTRICT ]
  30. REVOKE [GRANT OPTION FOR] { {CREATE | USAGE} [,...] 
  31.        | ALL [PRIVILEGES] }
  32.        ON SCHEMA <schemaname> [, ...]
  33.        FROM {<rolename> | PUBLIC} [, ...]
  34.        [CASCADE | RESTRICT]
  36. REVOKE [GRANT OPTION FOR] { CREATE | ALL [PRIVILEGES] }
  37.        ON TABLESPACE <tablespacename> [, ...]
  38.        FROM { <rolename> | PUBLIC } [, ...]
  39.        [CASCADE | RESTRICT]
  41. REVOKE [ADMIN OPTION FOR] <parent_role> [, ...] 
  42.        FROM <member_role> [, ...]
  43.        [CASCADE | RESTRICT]

Description

REVOKE command revokes previously granted privileges from one or more roles. The key word PUBLIC refers to the implicitly defined group of all roles.

See the description of the GRANT command for the meaning of the privilege types.

Note that any particular role will have the sum of privileges granted directly to it, privileges granted to any role it is presently a member of, and privileges granted to PUBLIC. Thus, for example, revoking SELECT privilege from PUBLIC does not necessarily mean that all roles have lost SELECT privilege on the object: those who have it granted directly or via another role will still have it.

If GRANT OPTION FOR is specified, only the grant option for the privilege is revoked, not the privilege itself. Otherwise, both the privilege and the grant option are revoked.

If a role holds a privilege with grant option and has granted it to other roles then the privileges held by those other roles are called dependent privileges. If the privilege or the grant option held by the first role is being revoked and dependent privileges exist, those dependent privileges are also revoked if CASCADE is specified, else the revoke action will fail. This recursive revocation only affects privileges that were granted through a chain of roles that is traceable to the role that is the subject of this REVOKE command. Thus, the affected roles may effectively keep the privilege if it was also granted through other roles.

When revoking membership in a role, GRANT OPTION is instead called ADMIN OPTION, but the behavior is similar.

Parameters

See GRANT.

Examples

Revoke insert privilege for the public on table films:

  1. REVOKE INSERT ON films FROM PUBLIC;

Revoke all privileges from role sally on view topten. Note that this actually means revoke all privileges that the current role granted (if not a superuser).

  1. REVOKE ALL PRIVILEGES ON topten FROM sally;

Revoke membership in role admins from user joe:

  1. REVOKE admins FROM joe;

Compatibility

The compatibility notes of the GRANT command also apply to REVOKE.

Either RESTRICT or CASCADE is required according to the standard, but HAWQ assumes RESTRICT by default.

See Also

GRANT