ClickHouse用户管理：ALTER USER语句详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00372/article/details/148325560

ClickHouse用户管理：ALTER USER语句详解

ClickHouse ClickHouse® 是一个免费的大数据分析型数据库管理系统。项目地址: https://gitcode.com/gh_mirrors/cli/ClickHouse

概述

在ClickHouse数据库系统中，ALTER USER语句是管理用户账户的核心命令之一。通过该命令，数据库管理员可以灵活地修改用户的各种属性和权限设置。本文将全面解析ALTER USER语句的语法结构、功能选项以及实际应用场景。

基本语法结构

ALTER USER语句的基本语法如下：

ALTER USER [IF EXISTS] 用户名 [RENAME TO 新用户名 |, 用户名2 [,...]] 
    [ON CLUSTER 集群名]
    [认证相关选项]
    [主机访问控制选项]
    [有效期设置]
    [默认角色设置]
    [权限授予选项]
    [配置管理选项]

主要功能详解

1. 用户重命名

ALTER USER old_name RENAME TO new_name

此操作可以修改现有用户的名称，但需要注意名称变更后相关权限可能需要重新配置。

2. 认证方式管理

ClickHouse支持多种认证方式：

密码认证：

ALTER USER user1 IDENTIFIED WITH plaintext_password BY '123456'
ALTER USER user1 IDENTIFIED WITH sha256_hash BY 'hash_value'

无密码认证：
```
ALTER USER user1 NOT IDENTIFIED
```

外部认证：

ALTER USER user1 IDENTIFIED WITH ldap SERVER 'ldap_server1'
ALTER USER user1 IDENTIFIED WITH kerberos REALM 'EXAMPLE.COM'

重要说明：

可以同时为单个用户配置多种认证方式
no_password不能与其他认证方式共存
低版本ClickHouse可能不支持多认证方式，降级前需处理

3. 主机访问控制

-- 允许特定主机访问
ALTER USER user1 ADD HOST IP '192.168.1.100'

-- 允许所有主机访问
ALTER USER user1 ADD HOST ANY

-- 禁止所有主机访问
ALTER USER user1 ADD HOST NONE

支持的主机指定方式包括：IP地址、主机名、正则表达式匹配等。

4. 有效期设置

-- 设置账户有效期至2025年底
ALTER USER user1 VALID UNTIL '2025-12-31'

-- 设置精确到期时间
ALTER USER user1 VALID UNTIL '2025-06-30 23:59:59 UTC'

5. 默认角色管理

-- 设置特定默认角色
ALTER USER user1 DEFAULT ROLE role1, role2

-- 设置所有已分配角色为默认
ALTER USER user1 DEFAULT ROLE ALL

-- 排除某些角色
ALTER USER user1 DEFAULT ROLE ALL EXCEPT role3

6. 权限授予控制(GRANTEES)

-- 允许用户将权限授予特定用户
ALTER USER admin_user GRANTEES user1, user2

-- 允许授予任何用户(默认)
ALTER USER admin_user GRANTEES ANY

-- 禁止授予权限
ALTER USER readonly_user GRANTEES NONE

-- 排除特定用户
ALTER USER manager GRANTEES ANY EXCEPT intern

7. 配置管理

-- 添加/修改配置
ALTER USER user1 MODIFY SETTINGS max_memory_usage = 10000000000

-- 删除配置
ALTER USER user1 DROP SETTINGS max_memory_usage

-- 管理配置模板
ALTER USER user1 ADD PROFILES 'profile1'
ALTER USER user1 DROP PROFILES 'profile2'

实际应用示例

示例1：综合用户配置

ALTER USER analyst 
    IDENTIFIED WITH sha256_hash BY '5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8'
    ADD HOST IP '10.0.0.%'
    VALID UNTIL '2024-12-31'
    DEFAULT ROLE reporting, analysis
    MODIFY SETTINGS max_memory_usage = 8000000000

示例2：重置认证方式

-- 保留最新添加的认证方式
ALTER USER temp_user RESET AUTHENTICATION METHODS TO NEW

-- 完全重置并设置新认证
ALTER USER temp_user IDENTIFIED WITH bcrypt_password BY 'new_secure_password'