跳到主要内容
跳到主要内容

故障排除

安装​

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

apt-key 功能已经被 高级包工具（APT）弃用。用户应使用 gpg 命令。请参阅 安装指南 文章。

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

  1. 查看是否已安装 gpg：

无法使用 apt-get 从 ClickHouse 仓库获取 deb 包​

  1. 检查防火墙设置。
  2. 如果由于某种原因无法访问仓库，请按照 安装指南 文章中所述下载软件包，并使用 sudo dpkg -i <packages> 命令手动安装它们。您还需要 tzdata 包。

无法使用 apt-get 从 ClickHouse 仓库更新 deb 包​

当 GPG 密钥更改时，可能会出现此问题。

请使用 设置 页面中的手册更新仓库配置。

使用 apt-get update 时出现不同的警告​

完整的警告消息如下：

要解决上述问题，请使用以下脚本：

因签名错误无法使用 Yum 获取软件包​

可能的问题：缓存错误，可能是在 2022-09 更新 GPG 密钥后损坏。

解决方案是清理 Yum 的缓存和库目录：

之后请按照 安装指南 进行操作。

连接到服务器​

可能的问题：

  • 服务器未运行。
  • 意外或错误的配置参数。

服务器未运行​

检查服务器是否在运行​

如果服务器未运行，请使用以下命令启动它：

检查日志​

clickhouse-server 的主日志默认位于 /var/log/clickhouse-server/clickhouse-server.log。

如果服务器成功启动，您应该看到以下字符串：

  • <Information> Application: starting up. — 服务器已启动。
  • <Information> Application: Ready for connections. — 服务器正在运行并准备接受连接。

如果 clickhouse-server 由于配置错误启动失败，您应该看到带有错误描述的 <Error> 字符串。例如：

如果您在文件末尾未看到错误，请从以下字符串开始筛查整个文件：

如果您尝试在服务器上启动第二个 clickhouse-server 实例，您会看到以下日志：

查看 system.d 日志​

如果您在 clickhouse-server 日志中没有找到任何有用的信息或没有日志，您可以使用以下命令查看 system.d 日志：

以交互模式启动 clickhouse-server​

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

配置参数​

检查：

  1. Docker 设置：

    • 如果您在 IPv6 网络中运行 ClickHouse，请确保设置 network=host。

  2. 端点设置。

    • 检查 listen_host 和 tcp_port 设置。
    • 默认情况下，ClickHouse 服务器仅接受本地主机连接。

  3. HTTP 协议设置：

    • 检查 HTTP API 的协议设置。

  4. 安全连接设置。

    • 检查：
    • 连接时使用正确的参数。例如，使用 clickhouse_client 的 port_secure 参数。

  5. 用户设置：

    • 可能使用了错误的用户名或密码。

查询处理​

如果 ClickHouse 无法处理查询，它会向客户端发送错误描述。在 clickhouse-client 中，您将在控制台中获得错误描述。如果使用 HTTP 接口，ClickHouse 会在响应体中发送错误描述。例如：

如果您使用 stack-trace 参数启动 clickhouse-client，ClickHouse 将返回带有错误描述的服务器堆栈跟踪。

您可能会看到关于连接中断的消息。在这种情况下，您可以重复查询。如果每次执行查询时连接都中断，请检查服务器日志中的错误。

查询处理的效率​

如果您发现 ClickHouse 工作得很慢，需要对服务器资源和网络进行负载分析，以优化您的查询。

您可以使用 clickhouse-benchmark 工具来分析查询。它显示每秒处理的查询数量、每秒处理的行数以及查询处理时间的百分位数。