ClickHouse/docs/en/sql-reference/statements/set-role.md

49 lines
1022 B
Markdown
Raw Normal View History

2020-07-11 11:05:49 +00:00
---
2022-08-28 14:53:34 +00:00
slug: /en/sql-reference/statements/set-role
sidebar_position: 51
sidebar_label: SET ROLE
2022-08-29 16:19:50 +00:00
title: "SET ROLE Statement"
2020-07-11 11:05:49 +00:00
---
Activates roles for the current user.
``` sql
SET ROLE {DEFAULT | NONE | role [,...] | ALL | ALL EXCEPT role [,...]}
```
2022-06-02 10:55:18 +00:00
## SET DEFAULT ROLE
2020-07-11 11:05:49 +00:00
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} [,...]
```
2022-06-02 10:55:18 +00:00
## Examples
2020-07-11 11:05:49 +00:00
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
```
2022-11-14 17:17:31 +00:00
Set all the granted roles as default except for specific roles `role1` and `role2`:
2020-07-11 11:05:49 +00:00
``` sql
SET DEFAULT ROLE ALL EXCEPT role1, role2 TO user
```