Устранение неполадок
Установка
Невозможно импортировать GPG ключи с keyserver.ubuntu.com с помощью apt-key
Функция apt-key
с Advanced package tool (APT) была устаревшей. Пользователям следует использовать команду gpg
вместо этого. Пожалуйста, обратитесь к статье руководства по установке.
Невозможно импортировать GPG ключи с keyserver.ubuntu.com с помощью gpg
- Проверьте, установлен ли ваш
gpg
:
Невозможно получить deb пакеты из репозитория ClickHouse с помощью apt-get
- Проверьте настройки брандмауэра.
- Если вы не можете получить доступ к репозиторию по какой-либо причине, загрузите пакеты, как описано в статье руководства по установке, и установите их вручную с помощью команды
sudo dpkg -i <packages>
. Вам также понадобится пакетtzdata
.
Невозможно обновить deb пакеты из репозитория ClickHouse с помощью apt-get
Проблема может возникнуть, если GPG ключ был изменен.
Пожалуйста, воспользуйтесь инструкциями на странице настройки для обновления конфигурации репозитория.
Вы получаете разные предупреждения с apt-get update
Завершенные сообщения о предупреждениях выглядят следующим образом:
Чтобы решить указанную выше проблему, используйте следующий скрипт:
Невозможно получить пакеты с Yum из-за неправильной подписи
Возможная проблема: кэш неверный, возможно, он поврежден после обновления GPG ключа в 2022-09.
Решение заключается в том, чтобы очистить кэш и каталог lib для 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
выводит все сообщения событий в консоль.
Параметры конфигурации
Проверьте:
-
Настройки Docker:
- Если вы запускаете ClickHouse в Docker в сети IPv6, убедитесь, что установлен
network=host
.
- Если вы запускаете ClickHouse в Docker в сети IPv6, убедитесь, что установлен
-
Настройки конечной точки.
- Проверьте настройки listen_host и tcp_port.
- По умолчанию сервер ClickHouse принимает подключения только от localhost.
-
Настройки протокола HTTP:
- Проверьте параметры протокола для HTTP API.
-
Настройки безопасного подключения.
- Проверьте:
- Параметр tcp_port_secure.
- Настройки для SSL-сертификатов.
- Используйте правильные параметры при подключении. Например, используйте параметр
port_secure
сclickhouse_client
.
- Проверьте:
-
Параметры пользователя:
- Возможно, вы используете неправильное имя пользователя или пароль.
Обработка запросов
Если ClickHouse не может обработать запрос, он отправляет описание ошибки клиенту. В clickhouse-client
вы получаете описание ошибки в консоли. Если вы используете HTTP интерфейс, ClickHouse отправляет описание ошибки в теле ответа. Например:
Если вы запускаете clickhouse-client
с параметром stack-trace
, ClickHouse возвращает стек сервера с описанием ошибки.
Вы можете увидеть сообщение о разрыве соединения. В этом случае вы можете повторить запрос. Если соединение разрывается каждый раз, когда вы выполняете запрос, проверьте журналы сервера на наличие ошибок.
Эффективность обработки запросов
Если вы видите, что ClickHouse работает слишком медленно, вам нужно профилировать нагрузку на ресурсы сервера и сеть для ваших запросов.
Вы можете использовать утилиту clickhouse-benchmark для профилирования запросов. Она показывает количество запросов, обработанных в секунду, количество строк, обработанных в секунду, и перцентили времени обработки запросов.