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

Устранение неполадок

Установка​

Не удаётся импортировать ключи GPG с keyserver.ubuntu.com с помощью apt-key​

Команда apt-key в Advanced Package Tool (APT) признана устаревшей. Вместо неё следует использовать команду gpg. Обратитесь к статье руководства по установке.

Не удаётся импортировать ключи GPG с keyserver.ubuntu.com с помощью gpg​

  1. Проверьте, установлен ли у вас gpg:
sudo apt-get install gnupg

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

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

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

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

Используйте инструкцию со страницы setup, чтобы обновить конфигурацию репозитория.

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

Полные сообщения предупреждений выглядят как один из следующих вариантов:

N: Пропускается получение настроенного файла 'main/binary-i386/Packages', так как репозиторий 'https://packages.clickhouse.com/deb stable InRelease' не поддерживает архитектуру 'i386'

E: Не удалось загрузить https://packages.clickhouse.com/deb/dists/stable/main/binary-amd64/Packages.gz  Неожиданный размер файла (30451 != 28154). Возможно, идёт синхронизация зеркала?

E: Репозиторий 'https://packages.clickhouse.com/deb stable InRelease' изменил значение 'Origin' с 'Artifactory' на 'ClickHouse'
E: Репозиторий 'https://packages.clickhouse.com/deb stable InRelease' изменил значение 'Label' с 'Artifactory' на 'ClickHouse'
N: Репозиторий 'https://packages.clickhouse.com/deb stable InRelease' изменил значение 'Suite' с 'stable' на ''
N: Это изменение необходимо явно подтвердить перед применением обновлений из данного репозитория. Подробности см. в справочной странице apt-secure(8).

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 из‑за неверной подписи​

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

Решение — очистить кэш и каталог lib для Yum:

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: Ошибка перезагрузки внешнего словаря 'event2id': Poco::Exception. Code: 1000, e.code() = 111, e.displayText() = Connection refused, e.what() = Connection refused

Если в конце файла нет сообщения об ошибке, просмотрите весь файл, начиная со строки:

<Information> Application: запускается.

Если вы попытаетесь запустить второй экземпляр clickhouse-server на сервере, вы увидите следующую запись в журнале:

2019.01.11 15:25:11.151730 [ 1 ] {} <Information> : Запуск ClickHouse 19.1.0 с ревизией 54413
2019.01.11 15:25:11.154578 [ 1 ] {} <Information> Application: запуск приложения
2019.01.11 15:25:11.156361 [ 1 ] {} <Information> StatusFile: Файл статуса ./status уже существует — некорректный перезапуск. Содержимое:
PID: 8510
Запущен в: 2019-01-11 15:24:23
Revision: 54413

2019.01.11 15:25:11.156673 [ 1 ] {} <Error> Application: DB::Exception: Невозможно заблокировать файл ./status. Другой экземпляр сервера в этом же каталоге уже запущен.
2019.01.11 15:25:11.156682 [ 1 ] {} <Information> Application: завершение работы приложения
2019.01.11 15:25:11.156686 [ 1 ] {} <Debug> Application: Деинициализация подсистемы: Logging Subsystem
2019.01.11 15:25:11.156716 [ 2 ] {} <Information> BaseDaemon: Остановка потока SignalListener

Просмотр журналов 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:

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

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

    • Проверьте параметры 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

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

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

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

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

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