Superset连接ClickHouse失败求助：未调用clickhouse-connect

核心问题定位 #

你遇到的情况是Superset未启用clickhouse-connect驱动，而是沿用旧的ClickHouse驱动逻辑，导致请求格式不符合ClickHouse的HTTP规范。以下是针对性解决步骤：

1. 确认依赖正确安装并加载 #

• 进入Superset容器，检查clickhouse-connect是否已安装且版本达标：

  docker exec -it <superset_container_name> pip list | grep clickhouse-connect
  

  若版本低于0.4.1或未安装，需重新构建容器加载本地依赖：

  docker-compose up -d --build superset
  

• 检查docker-compose.yml是否正确挂载requirements-local.txt：

  volumes:
    - ./docker/requirements-local.txt:/app/requirements-local.txt
  

  官方Superset镜像启动时会自动安装该文件内的依赖，自定义镜像需确保启动脚本包含pip install -r requirements-local.txt步骤。

2. 修正Superset的ClickHouse连接配置 #

连接ClickHouse时必须使用clickhouse+connect作为SQLAlchemy URI前缀，旧的clickhouse://前缀会调用过时驱动，示例格式：

clickhouse+connect://用户名:密码@superset.typhur.cn:8123/数据库名

• 进入Superset数据源配置页，删除原连接后重新创建，严格遵循上述URI格式。
• 确认连接所用的ClickHouse用户拥有目标数据库的访问权限。

3. 验证ClickHouse的HTTP服务配置 #

• 检查ClickHouse的config.xml配置，确保：
  • HTTP服务已启用（确认<http_port>8123</http_port>配置存在）
  • 允许外部访问（添加<listen_host>0.0.0.0</listen_host>）
• 测试Superset容器到ClickHouse的网络连通性：

  docker exec -it <superset_container_name> curl http://superset.typhur.cn:8123
  

  正常返回Ok.则网络通畅，否则排查防火墙、DNS解析或ClickHouse服务状态。

4. 直接测试clickhouse-connect连接 #

在Superset容器内执行Python脚本，排除Superset配置外的问题：

import clickhouse_connect
# 替换为你的实际连接信息
client = clickhouse_connect.get_client(
    host='superset.typhur.cn',
    port=8123,
    user='your_user',
    password='your_password',
    database='your_database'
)
# 执行简单查询验证
result = client.query('SELECT 1')
print(result.result_set)

若脚本执行成功，说明驱动和网络正常，问题集中在Superset连接配置；若失败，需排查ClickHouse用户权限或网络策略。

内容的提问来源于stack exchange，提问作者Jc Huang