Categories:

User & Security DDL (Roles)

# CREATE ROLE¶

Create a new role or replace an existing role in the system.

After creating roles, you can grant object privileges to the role and then grant the role to other roles or individual users to enable access control security for objects in the system.

Note

Only user administrators (i.e. users with the USERADMIN role or higher), or another role with the CREATE ROLE privilege on the account, can create roles.

## Syntax¶

CREATE [ OR REPLACE ] ROLE [ IF NOT EXISTS ] <name>
[ [ WITH ] TAG ( <tag_key> = 'tag_value' [ , <tag_key> = 'tag_value' , ... ] ) ]
[ COMMENT = '<string_literal>' ]


## Required Parameters¶

name

Identifier for the role; must be unique for your account.

The identifier must start with an alphabetic character and cannot contain spaces or special characters unless the entire identifier string is enclosed in double quotes (e.g. "My object"). Identifiers enclosed in double quotes are also case-sensitive.

For more details, see Identifier Requirements.

## Optional Parameters¶

TAG ( tag_key = 'tag_value' [ , tag_key = 'tag_value' , ... ] ) ]

Specifies the tag name (i.e. the key) and the tag value.

The tag value is always a string and the maximum number of characters for the tag value is 256. The maximum number of tags that can be set on an object is 20.

COMMENT = 'string_literal'

Specifies a comment for the role.

Default: No value

## Examples¶

CREATE ROLE myrole;