Skip to main content

安装

无法使用 apt-key 从 keyserver.ubuntu.com 导入 GPG 密钥

Advanced package tool (APT) 中的 apt-key 功能已被弃用。请改用 gpg 命令。请参阅安装指南

无法使用 gpg 从 keyserver.ubuntu.com 导入 GPG 密钥

  1. 检查是否已安装 gpg

无法通过 apt-get 从 ClickHouse 软件源获取 deb 软件包

  1. 检查防火墙设置。
  2. 如果因任何原因无法访问该软件源,请按照安装指南中的说明下载软件包,并使用 sudo dpkg -i <packages> 命令手动安装。你还需要安装 tzdata 软件包。

无法通过 apt-get 从软件源更新 deb 软件包

更换 GPG 密钥后,可能会出现此问题。 请按照 setup 页面中的手动说明更新仓库配置。

执行 apt-get update 时会出现不同的警告

完整的警告信息如下:
要解决上述问题,请使用以下脚本:

因签名错误而无法通过 Yum 获取软件包

可能的问题:缓存不正确,可能是在 2022-09 更新 GPG 密钥后损坏了。 解决方法是清理 Yum 的缓存和 lib 目录:
然后按照安装指南

连接到服务器

可能的问题:
  • 服务器未运行。
  • 配置参数异常或有误。

服务器未启动

检查服务器是否在运行

如果服务器尚未运行,请使用以下命令启动:

检查日志

clickhouse-server 的主日志默认位于 /var/log/clickhouse-server/clickhouse-server.log 如果 server 成功启动,你应该会看到以下内容:
  • <Information> Application: starting up. — server 已启动。
  • <Information> Application: Ready for connections. — server 正在运行,并已准备好接受连接。
如果 clickhouse-server 因配置错误而启动失败,你应该会看到 <Error> 字样及相应的错误描述。例如:
如果你在文件末尾没有看到错误,请从以下字符串开始检查整个文件:
如果你尝试在服务器上启动第二个 clickhouse-server 实例,会看到以下日志:

查看 system.d 日志

如果在 clickhouse-server 日志中找不到任何有用信息,或者根本没有日志,可以使用以下命令查看 system.d 日志:

在交互模式下启动 clickhouse-server

此命令会以交互式应用的方式启动服务器,并使用自动启动脚本的标准参数。在这种模式下,clickhouse-server 会在控制台打印所有事件消息。

配置参数

检查:
  1. Docker 设置:
    • 如果您在 IPv6 网络中的 Docker 容器里运行 ClickHouse,请确保已设置 network=host
  2. 端点设置。
    • 检查 listen_hosttcp_port 设置。
    • 默认情况下,ClickHouse server 仅接受来自 localhost 的连接。
  3. HTTP protocol 设置:
    • 检查 HTTP API 的协议设置。
  4. 安全连接设置。
    • 检查:
    • 连接时请使用正确的参数。例如,对 clickhouse_client 使用 port_secure 参数。
  5. 用户设置:
    • 您使用的用户名或密码可能不正确。

查询处理

如果 ClickHouse 无法处理查询,它会向客户端返回错误描述。在 clickhouse-client 中,你会在控制台看到错误描述。如果使用的是 HTTP 接口,ClickHouse 会在响应正文中返回错误描述。例如:
如果使用 stack-trace 参数启动 clickhouse-client,ClickHouse 会返回服务器的栈跟踪以及错误描述。 你可能会看到有关连接中断的消息。在这种情况下,可以重新执行该查询。如果每次执行查询时连接都会中断,请检查服务器日志中是否有错误。

查询处理效率

如果你发现 ClickHouse 运行过慢,就需要分析查询对服务器资源和网络的负载情况。 你可以使用 clickhouse-benchmark 工具来分析查询。它会显示每秒处理的查询数、每秒处理的行数,以及查询处理时间的各分位数。
最后修改于 2026年7月3日