Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

ALTER ROLE

View as MarkdownEdit this pageReport an issueSet up docs MCP

Changes roles.

Syntax:

ALTER ROLE [IF EXISTS] name1 [RENAME TO new_name |, name2 [,...]]
    [ON CLUSTER cluster_name]
    [DROP ALL PROFILES]
    [DROP ALL SETTINGS]
    [DROP PROFILES 'profile_name' [,...] ]
    [DROP SETTINGS variable [,...] ]
    [ADD|MODIFY SETTINGS variable [= value] [MIN [=] min_value] [MAX [=] max_value] [CONST|READONLY|WRITABLE|CHANGEABLE_IN_READONLY] | PROFILE 'profile_name'] [,...]
    [SET variable [= value] [MIN [=] min_value] [MAX [=] max_value] [CONST|READONLY|WRITABLE|CHANGEABLE_IN_READONLY] [,...] ]
    [ADD PROFILES 'profile_name' [,...] ]

SET variable = value is an alias for MODIFY SETTING variable = value: it changes a single setting in place while keeping the rest, unlike the bare SETTINGS clause which replaces the whole settings list and also removes all inherited (parent) profiles.

Part of: ALTER

Related: CREATE ROLE, ALTER, SET ROLE, GRANT

Navigation