ClickHouse/docs/en/sql-reference/statements/set-role.md
2022-11-14 12:17:31 -05:00

49 lines
1022 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
slug: /en/sql-reference/statements/set-role
sidebar_position: 51
sidebar_label: SET ROLE
title: "SET ROLE Statement"
---
Activates roles for the current user.
``` sql
SET ROLE {DEFAULT | NONE | role [,...] | ALL | ALL EXCEPT role [,...]}
```
## SET DEFAULT ROLE
Sets default roles to a user.
Default roles are automatically activated at user login. You can set as default only the previously granted roles. If the role isnt granted to a user, ClickHouse throws an exception.
``` sql
SET DEFAULT ROLE {NONE | role [,...] | ALL | ALL EXCEPT role [,...]} TO {user|CURRENT_USER} [,...]
```
## Examples
Set multiple default roles to a user:
``` sql
SET DEFAULT ROLE role1, role2, ... TO user
```
Set all the granted roles as default to a user:
``` sql
SET DEFAULT ROLE ALL TO user
```
Purge default roles from a user:
``` sql
SET DEFAULT ROLE NONE TO user
```
Set all the granted roles as default except for specific roles `role1` and `role2`:
``` sql
SET DEFAULT ROLE ALL EXCEPT role1, role2 TO user
```