Skip to main content
Skip to main content
Edit this page

Устранение неисправностей

Установка дистрибутива​

Не получается скачать deb-пакеты из репозитория ClickHouse с помощью Apt-get​

  • Проверьте настройки брандмауэра.
  • Если по какой-либо причине вы не можете получить доступ к репозиторию, скачайте пакеты как описано в разделе Начало работы и установите их вручную командой sudo dpkg -i <packages>. Также, необходим пакет tzdata.

Соединение с сервером​

Возможные проблемы:

  • Сервер не запущен.
  • Неожиданные или неправильные параметры конфигурации.

Сервер не запущен​

Проверьте, запущен ли сервер

Команда:

Если сервер не запущен, запустите его с помощью команды:

Проверьте журналы

Основной лог 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 выводит сообщения в консоль.

Параметры конфигурации​

Проверьте:

  • Настройки Docker.

    При запуске ClickHouse в Docker в сети IPv6 убедитесь, что установлено network=host.

  • Параметры endpoint.

    Проверьте настройки listen_host и tcp_port.

    По умолчанию, сервер ClickHouse принимает только локальные подключения.

  • Настройки протокола HTTP.

    Проверьте настройки протокола для HTTP API.

  • Параметры безопасного подключения.

    Проверьте:

    • Настройку tcp_port_secure.
    • Параметры для SSL-сертификатов.

    Используйте правильные параметры при подключении. Например, используйте параметр port_secure при использовании clickhouse_client.

  • Настройки пользователей.

    Возможно, вы используете неверное имя пользователя или пароль.

Обработка запросов​

Если ClickHouse не может обработать запрос, он отправляет клиенту описание ошибки. В clickhouse-client вы получаете описание ошибки в консоли. При использовании интерфейса HTTP, ClickHouse отправляет описание ошибки в теле ответа. Например:

Если вы запускаете clickhouse-client c параметром stack-trace, то ClickHouse возвращает описание ошибки и соответствующий стек вызовов функций на сервере.

Может появиться сообщение о разрыве соединения. В этом случае необходимо повторить запрос. Если соединение прерывается каждый раз при выполнении запроса, следует проверить журналы сервера на наличие ошибок.

Скорость обработки запросов​

Если вы видите, что ClickHouse работает слишком медленно, необходимо профилировать загрузку ресурсов сервера и сети для ваших запросов.

Для профилирования запросов можно использовать утилиту clickhouse-benchmark. Она показывает количество запросов, обработанных за секунду, количество строк, обработанных за секунду и перцентили времени обработки запросов.