ClickHouse/docs/zh/operations/troubleshooting.md

machine_translated	machine_translated_rev	toc_priority	toc_title
true	b111334d66	46	疑难解答

疑难解答

• 安装方式
• 连接到服务器
• 查询处理
• 查询处理效率

安装方式

您无法使用Apt-get从ClickHouse存储库获取Deb软件包

• 检查防火墙设置。
• 如果出于任何原因无法访问存储库，请按照以下文件中的描述下载软件包 开始 文章并使用手动安装它们 sudo dpkg -i <packages> 指挥部 您还需要 tzdata 包。

连接到服务器

可能出现的问题:

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

服务器未运行

检查服务器是否运行nnig

命令:

$ sudo service clickhouse-server status

如果服务器没有运行，请使用以下命令启动它:

$ sudo service clickhouse-server start

检查日志

主日志 clickhouse-server 是在 /var/log/clickhouse-server/clickhouse-server.log 默认情况下。

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

• <Information> Application: starting up. — Server started.
• <Information> Application: Ready for connections. — Server is running and 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

请参阅系统。d日志

如果你没有找到任何有用的信息 clickhouse-server 日志或没有任何日志，您可以查看 system.d 使用命令记录:

$ sudo journalctl -u clickhouse-server

在交互模式下启动clickhouse服务器

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

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

配置参数

检查:

• 码头工人设置。

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

• 端点设置。

  检查 listen_host 和 tcp_port 设置。

  ClickHouse服务器默认情况下仅接受本地主机连接。

• HTTP协议设置。

  检查HTTP API的协议设置。

• 安全连接设置。

  检查:

  • 该 tcp_port_secure 设置。
  • 设置 SSL序列.

  连接时使用正确的参数。 例如，使用 port_secure 参数 clickhouse_client.

• 用户设置。

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

查询处理

如果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

如果你开始 clickhouse-client 与 stack-trace 参数，ClickHouse返回包含错误描述的服务器堆栈跟踪。

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

查询处理效率

如果您发现ClickHouse工作速度太慢，则需要为查询分析服务器资源和网络的负载。

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