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

故障排除

安装​

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

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

无法通过 gpg 从 keyserver.ubuntu.com 导入 GPG 密钥​

  1. 查看您的 gpg 是否已安装：
sudo apt-get install gnupg

无法通过 apt-get 从 ClickHouse 仓库获取 deb 包​

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

无法通过 apt-get 更新 ClickHouse 仓库中的 deb 包​

当 GPG 密钥更改时，可能会发生此问题。

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

您在使用 apt-get update 时收到不同的警告​

完成的警告信息为以下之一：

N: Skipping acquire of configured file 'main/binary-i386/Packages' as repository 'https://packages.clickhouse.com/deb stable InRelease' doesn't support architecture 'i386'

E: Failed to fetch https://packages.clickhouse.com/deb/dists/stable/main/binary-amd64/Packages.gz  File has unexpected size (30451 != 28154). Mirror sync in progress?

E: Repository 'https://packages.clickhouse.com/deb stable InRelease' changed its 'Origin' value from 'Artifactory' to 'ClickHouse'
E: Repository 'https://packages.clickhouse.com/deb stable InRelease' changed its 'Label' value from 'Artifactory' to 'ClickHouse'
N: Repository 'https://packages.clickhouse.com/deb stable InRelease' changed its 'Suite' value from 'stable' to ''
N: This must be accepted explicitly before updates for this repository can be applied. See apt-secure(8) manpage for details.

Err:11 https://packages.clickhouse.com/deb stable InRelease
400  Bad Request [IP: 172.66.40.249 443]

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

sudo rm /var/lib/apt/lists/packages.clickhouse.com_* /var/lib/dpkg/arch /var/lib/apt/lists/partial/packages.clickhouse.com_*
sudo apt-get clean
sudo apt-get autoclean

由于签名错误无法通过 Yum 获取包​

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

解决方案是清除 Yum 的缓存和 lib 目录：

sudo find /var/lib/yum/repos/ /var/cache/yum/ -name 'clickhouse-*' -type d -exec rm -rf {} +
sudo rm -f /etc/yum.repos.d/clickhouse.repo

之后按照 安装指南 操作

连接到服务器​

可能的问题：

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

服务器未运行​

检查服务器是否在运行​

sudo service clickhouse-server status

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

sudo service clickhouse-server start

检查日志​

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

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

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

如果 clickhouse-server 启动失败并出现配置错误，您应该看到 <Error> 字符串及其错误描述。例如：

2019.01.11 15:23:25.549505 [ 45 ] {} <Error> ExternalDictionaries: Failed reloading 'event2id' external dictionary: Poco::Exception. Code: 1000, e.code() = 111, e.displayText() = Connection refused, e.what() = Connection refused

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

<Information> Application: starting up.

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

2019.01.11 15:25:11.151730 [ 1 ] {} <Information> : Starting ClickHouse 19.1.0 with revision 54413
2019.01.11 15:25:11.154578 [ 1 ] {} <Information> Application: starting up
2019.01.11 15:25:11.156361 [ 1 ] {} <Information> StatusFile: Status file ./status already exists - unclean restart. Contents:
PID: 8510
Started at: 2019-01-11 15:24:23
Revision: 54413

2019.01.11 15:25:11.156673 [ 1 ] {} <Error> Application: DB::Exception: Cannot lock file ./status. Another server instance in same directory is already running.
2019.01.11 15:25:11.156682 [ 1 ] {} <Information> Application: shutting down
2019.01.11 15:25:11.156686 [ 1 ] {} <Debug> Application: Uninitializing subsystem: Logging Subsystem
2019.01.11 15:25:11.156716 [ 2 ] {} <Information> BaseDaemon: Stop SignalListener thread

查看 system.d 日志​

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

sudo journalctl -u clickhouse-server

在交互模式下启动 clickhouse-server​

sudo -u clickhouse /usr/bin/clickhouse-server --config-file /etc/clickhouse-server/config.xml

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

配置参数​

检查：

  1. Docker 设置：

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

  2. 端点设置。

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

  3. HTTP 协议设置：

    • 检查 HTTP API 的协议设置。

  4. 安全连接设置。

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

  5. 用户设置：

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

查询处理​

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

$ curl 'http://localhost:8123/' --data-binary "SELECT a"
Code: 47, e.displayText() = DB::Exception: Unknown identifier: a. Note that there are no tables (FROM clause) in your query, context: required_names: 'a' source_tables: table_aliases: private_aliases: column_aliases: public_columns: 'a' masked_columns: array_join_columns: source_columns: , e.what() = DB::Exception

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

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

查询处理的效率​

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

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