安装
无法使用 apt-key 从 keyserver.ubuntu.com 导入 GPG 密钥
apt-key 功能已被弃用。请改用 gpg 命令。请参阅安装指南。
无法使用 gpg 从 keyserver.ubuntu.com 导入 GPG 密钥
- 检查是否已安装
gpg:
无法通过 apt-get 从 ClickHouse 软件源获取 deb 软件包
- 检查防火墙设置。
- 如果因任何原因无法访问该软件源,请按照安装指南中的说明下载软件包,并使用
sudo dpkg -i <packages>命令手动安装。你还需要安装tzdata软件包。
无法通过 apt-get 从软件源更新 deb 软件包
执行 apt-get update 时会出现不同的警告
因签名错误而无法通过 Yum 获取软件包
连接到服务器
- 服务器未运行。
- 配置参数异常或有误。
服务器未启动
检查服务器是否在运行
检查日志
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 会在控制台打印所有事件消息。
配置参数
-
Docker 设置:
- 如果您在 IPv6 网络中的 Docker 容器里运行 ClickHouse,请确保已设置
network=host。
- 如果您在 IPv6 网络中的 Docker 容器里运行 ClickHouse,请确保已设置
-
端点设置。
- 检查 listen_host 和 tcp_port 设置。
- 默认情况下,ClickHouse server 仅接受来自 localhost 的连接。
-
HTTP protocol 设置:
- 检查 HTTP API 的协议设置。
-
安全连接设置。
- 检查:
- tcp_port_secure 设置。
- SSL certificates 相关设置。
- 连接时请使用正确的参数。例如,对
clickhouse_client使用port_secure参数。
- 检查:
-
用户设置:
- 您使用的用户名或密码可能不正确。
查询处理
clickhouse-client 中,你会在控制台看到错误描述。如果使用的是 HTTP 接口,ClickHouse 会在响应正文中返回错误描述。例如:
stack-trace 参数启动 clickhouse-client,ClickHouse 会返回服务器的栈跟踪以及错误描述。
你可能会看到有关连接中断的消息。在这种情况下,可以重新执行该查询。如果每次执行查询时连接都会中断,请检查服务器日志中是否有错误。
查询处理效率
clickhouse-benchmark 工具来分析查询。它会显示每秒处理的查询数、每秒处理的行数,以及查询处理时间的各分位数。