Перейти к основному содержимому
Перейти к основному содержимому

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

Установка​

Невозможно импортировать GPG ключи с keyserver.ubuntu.com с помощью apt-key​

Функция apt-key с Advanced package tool (APT) устарела. Пользователям следует вместо этого использовать команду gpg. Пожалуйста, обратитесь к статье руководство по установке.

Невозможно импортировать GPG ключи с keyserver.ubuntu.com с помощью gpg​

  1. Проверьте, установлена ли ваша gpg:

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

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

Невозможно обновить deb пакеты из репозитория ClickHouse с помощью apt-get​

Проблема может возникнуть, если GPG ключ изменился.

Пожалуйста, используйте руководство с страницы настройка для обновления конфигурации репозитория.

Вы получаете различные предупреждения с apt-get update​

Полные сообщения об ошибках могут быть одними из следующих:

Чтобы решить вышеперечисленные проблемы, пожалуйста, используйте следующий скрипт:

Невозможно получить пакеты с Yum из-за неверной подписи​

Возможная проблема: кэш неверный, возможно, он поврежден после обновления GPG ключа в 2022-09.

Решением является очистка кэша и библиотеки для 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:

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

  2. Настройки конечной точки.

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

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

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

  4. Настройки защищенного соединения.

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

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

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

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

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

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

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

Эффективность обработки запросов​

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

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