SET ROLE

激活当前用户的角色。

SET ROLE {DEFAULT | NONE | role [,...] | ALL | ALL EXCEPT role [,...]}

SET DEFAULT ROLE

为用户设置默认角色。默认角色会在用户登录时自动激活。只有先前已授予用户的角色才能设为默认角色。如果某个角色未授予给用户，ClickHouse 会抛出异常。

SET DEFAULT ROLE {NONE | role [,...] | ALL | ALL EXCEPT role [,...]} TO {user|CURRENT_USER} [,...] [ON CLUSTER cluster_name]

ON CLUSTER 既可以紧跟在 SET DEFAULT ROLE 之后，也可以放在查询末尾，用于在集群的每个主机上执行该查询。CURRENT_USER 会在查询分发之前于发起服务器上解析。SET ROLE 仅作用于当前会话，因此不支持 ON CLUSTER 子句。

为用户设置多个默认角色：

SET DEFAULT ROLE role1, role2, ... TO user

将授予某个用户的所有角色设为默认角色：

SET DEFAULT ROLE ALL TO user

移除用户的默认角色：

SET DEFAULT ROLE NONE TO user

将除特定角色 role1 和 role2 外的所有已授予角色设为默认：

SET DEFAULT ROLE ALL EXCEPT role1, role2 TO user

在集群的每台主机上设置默认角色：

SET DEFAULT ROLE role1 TO user ON CLUSTER my_cluster
SET DEFAULT ROLE ON CLUSTER my_cluster role1 TO user