SuperAPI AI 工具集

clickhouse-cloud-management

数据与分析

查看项目

更新于 10-16 00:20

技能介绍

用途:该技能面向 ClickHouse Cloud 的用户与权限管理,通过 HTTP 接口执行 SQL 命令,覆盖数据库用户创建、权限授予(GRANT/REVOKE)、删除用户、连接测试与认证问题排查,并帮助区分 API 密钥与数据库用户。

主要能力:支持 CREATE USER、GRANT、DROP USER 等操作;可创建只读用户(SETTINGS readonly = 1)、授予库表级权限(如 GRANT SELECT ON deribit.* TO my_reader)、用 SHOW USERS 验证用户、用 SELECT 1 测试连通性。

使用方式:ClickHouse Cloud 公网仅暴露 HTTP 接口,端口 443,使用 HTTPS,非原生协议;原生协议需 AWS PrivateLink。示例:curl -s "https://default:PASSWORD@HOST:443/" --data-binary "CREATE USER my_reader IDENTIFIED BY 'StrongPass@2025!' SETTINGS readonly = 1"。密码策略要求至少 12 位、含大写字母与特殊字符。凭据可从 1Password 获取,例如 op item get "gapless-deribit-clickhouse" --vault Engineering --reveal。

适用场景:为应用创建数据库用户、管理权限、排查认证失败或权限拒绝、确认连接超时原因。

限制:API 密钥只能在 Cloud Console 创建,无法通过 SQL 完成;数据库用户与 API 密钥认证对象不同。表/列 COMMENT 被视为唯一事实来源,建表建列应包含 COMMENT。Python 应用建议使用 clickhouse-connect。创建用户后可配合 clickhouse-pydantic-config 生成 DBeaver 配置。