apt-key 功能已被弃用。请改用 gpg 命令。请参阅安装指南。
- 检查是否已安装
gpg:
- 检查防火墙设置。
- 如果因任何原因无法访问该软件源,请按照安装指南中的说明下载软件包,并使用
sudo dpkg -i <packages>命令手动安装。你还需要安装tzdata软件包。
- 服务器未运行。
- 配置参数异常或有误。
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 实例,会看到以下日志:
clickhouse-server 日志中找不到任何有用信息,或者根本没有日志,可以使用以下命令查看 system.d 日志:
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 运行过慢,就需要分析查询对服务器资源和网络的负载情况。
你可以使用 clickhouse-benchmark 工具来分析查询。它会显示每秒处理的查询数、每秒处理的行数,以及查询处理时间的各分位数。