REVOKE (Distinct Type Privileges)

This form of the REVOKE statement removes the privileges on a distinct type.

Invocation

This statement can be embedded in an application program or issued interactively. It is an executable statement that can be dynamically prepared.

Authorization

The privileges held by the authorization ID of the statement must include at least one of the following:

• For each distinct type identified in the statement:
  • Every privilege specified in the statement
  • The system authority of *OBJMGT on the distinct type
  • The system authority *EXECUTE on the library containing the distinct type
• Administrative authority

Syntax

                  .-PRIVILEGES-.
>>-REVOKE--+-ALL--+------------+-+------------------------------>
           | .-,---------.       |
           | V           |       |
           '---+-ALTER-+-+-------'
               '-USAGE-'
 
                           .-,------------------.
       .-DISTINCT-.        V                    |
>--ON--+----------+--TYPE----distinct-type-name-+--------------->
 
         .-,----------------------.
         V                        |
>--FROM----+-authorization-name-+-+----------------------------><
           '-PUBLIC-------------'
 

Description

ALL or ALL PRIVILEGES

Revokes one or more distinct type privileges from each authorization-name. The privileges revoked are those privileges on the identified distinct types that were granted to the authorization-names. Note that revoking ALL PRIVILEGES on a distinct type is not the same as revoking the system authority of *ALL.

If you do not use ALL, you must use one or more of the keywords listed below. Each keyword revokes the privilege described.

ALTER

Revokes the privilege to use the COMMENT statement.

USAGE

Revokes the privilege to use distinct types in tables, functions, procedures, or as the source type in a CREATE DISTINCT TYPE statement.

ON DISTINCT TYPE distinct-type-name

Identifies the distinct types from which you are revoking privileges. The distinct-type-name must identify a distinct type that exists at the current server.

FROM

Identifies from whom the privileges are revoked.

authorization-name,...

Lists one or more authorization IDs. Do not specify the same authorization-name more than once.

PUBLIC

Revokes the specified privileges from PUBLIC.

Notes

Multiple grants: If authorization ID A granted the same privilege to authorization ID B more than once, revoking that privilege from B nullifies all those grants.

Revoking WITH GRANT OPTION: The only way to revoke the WITH GRANT OPTION is to revoke ALL.

Privilege warning: Revoking a specific privilege from a user does not necessarily prevent that user from performing an action that requires that privilege. For example, the user may still have the privilege through PUBLIC or administrative privileges.

Corresponding system authorities: When a distinct type privilege is revoked, the corresponding system authorities are revoked. For information on the system authorities that correspond to SQL privileges see GRANT (Distinct Type Privileges).

Syntax alternatives: The following keywords are synonyms supported for compatibility to prior releases. These keywords are non-standard and should not be used:

• The keyword DATA can be used as a synonym for DISTINCT.

Example

Revoke the USAGE privilege on distinct type SHOESIZE from user JONES.

   REVOKE USAGE
     ON DISTINCT TYPE SHOESIZE
     FROM JONES