Updated on 2025-07-22 GMT+08:00

DROP ROLE

Function

DROP ROLE deletes a specified role.

Precautions

If a "role is being used by other users" error is displayed when you run DROP ROLE, it might be that threads cannot respond to signals in a timely manner during the CLEAN CONNECTION process. As a result, connections are not completely cleared. In this case, you need to run CLEAN CONNECTION again.

  • Be cautious when using DROP OBJECT (e.g., DATABASE, USER/ROLE, SCHEMA, TABLE, VIEW) as it may cause data loss, especially with CASCADE deletions. Always back up data before proceeding.
  • For more information about development and design specifications, see Development and Design Proposal.

Syntax

1
DROP ROLE [ IF EXISTS ] role_name [, ...];

Parameter Description

Table 1 DROP ROLE parameters

Parameter

Description

Value Range

IF EXISTS

Sends a notice instead of an error if the specified role does not exist.

-

role_name

Specifies the name of the role to be deleted.

An existing role.

Examples

Delete the manager role:

1
DROP ROLE manager;

Helpful Links

CREATE ROLE, ALTER ROLE, SET ROLE