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

---
slug: /en/sql-reference/statements/alter/role
sidebar_position: 46
sidebar_label: ROLE
---

## ALTER ROLE

Changes roles.

Syntax:

``` sql
ALTER ROLE [IF EXISTS] name1 [RENAME TO new_name |, name2 [,...]] 
    [ON CLUSTER cluster_name]
    [ADD|MODIFY SETTINGS variable [= value] [MIN [=] min_value] [MAX [=] max_value] [CONST|READONLY|WRITABLE|CHANGEABLE_IN_READONLY] | PROFILE 'profile_name'] [,...]
    [DROP SETTINGS variable [,...] ]
    [ADD PROFILES 'profile_name' [,...] ]
    [DROP PROFILES 'profile_name' [,...] ]
    [DROP ALL PROFILES]
    [DROP ALL SETTINGS]
```
[docs] split the ALTER article (#12502) * initial split * initial adjust links * make en buildable * re-normalize 2020-07-14 21:02:41 +00:00			`---`
add slugs 2022-08-28 14:53:34 +00:00			`slug: /en/sql-reference/statements/alter/role`
Removed /ja folder, cleaned up /ru markdown 2022-04-09 13:29:05 +00:00			`sidebar_position: 46`
			`sidebar_label: ROLE`
[docs] split the ALTER article (#12502) * initial split * initial adjust links * make en buildable * re-normalize 2020-07-14 21:02:41 +00:00			`---`

Remove H1 anchor tags from docs 2022-06-02 10:55:18 +00:00			`## ALTER ROLE`
[docs] split the ALTER article (#12502) * initial split * initial adjust links * make en buildable * re-normalize 2020-07-14 21:02:41 +00:00
			`Changes roles.`

			`Syntax:`

			``` sql
update syntax for create/alter role 2024-09-19 09:29:05 +00:00			`ALTER ROLE [IF EXISTS] name1 [RENAME TO new_name \|, name2 [,...]]`
			`[ON CLUSTER cluster_name]`
Merge branch 'master' into add-syntax-alter-user-modify-settings # Conflicts: # docs/en/sql-reference/statements/alter/role.md # docs/en/sql-reference/statements/alter/settings-profile.md # docs/ru/sql-reference/statements/alter/role.md # docs/ru/sql-reference/statements/alter/settings-profile.md # src/Access/SettingsProfileElement.cpp # src/Access/SettingsProfileElement.h # src/Interpreters/Context.cpp # src/Interpreters/Context.h # src/Parsers/Access/ASTCreateUserQuery.cpp # src/Parsers/Access/ParserCreateRoleQuery.cpp # src/Parsers/Access/ParserCreateSettingsProfileQuery.cpp # src/Parsers/Access/ParserCreateUserQuery.cpp # src/Parsers/Access/ParserSettingsProfileElement.cpp # tests/queries/0_stateless/01294_create_settings_profile.reference 2024-11-18 21:13:27 +00:00			`[ADD\|MODIFY SETTINGS variable [= value] [MIN [=] min_value] [MAX [=] max_value] [CONST\|READONLY\|WRITABLE\|CHANGEABLE_IN_READONLY] \| PROFILE 'profile_name'] [,...]`
Add syntax ALTER USER {ADD\|MODIFY\|DROP SETTING}, ALTER USER {ADD\|DROP PROFILE}, the same for ALTER ROLE and ALTER PROFILE. 2023-12-01 03:26:43 +00:00			`[DROP SETTINGS variable [,...] ]`
			`[ADD PROFILES 'profile_name' [,...] ]`
			`[DROP PROFILES 'profile_name' [,...] ]`
			`[DROP ALL PROFILES]`
			`[DROP ALL SETTINGS]`
[docs] split the ALTER article (#12502) * initial split * initial adjust links * make en buildable * re-normalize 2020-07-14 21:02:41 +00:00			```