Skip to main content
Version: Latest-3.2

CREATE ROLE

Description

Creates a role. After a role is created, you can grant privileges to the role and then assign this role to a user or another role. This way, the privileges associated with this role are passed on to users or roles.

tip

Only users with the user_admin role has the privilege to perform this operation.

Syntax

CREATE ROLE <role_name>

Parameters

role_name: the name of the role. For the naming conventions, see System limits.

Note that the created role name cannot be the same as system-defined roles: root, cluster_admin, db_admin, user_admin, and public.

Limits

By default, a user can have a maximum of 64 roles. You can adjust this setting by using the FE dynamic parameter privilege_max_total_roles_per_user. A role can have a maximum of 16 inheritance levels. You can adjust this setting by using the FE dynamic parameter privilege_max_role_depth.

Examples

Create a role.

CREATE ROLE role1;

References