Skip to main content

Установка

Не удаётся импортировать ключи 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-ключ. Чтобы обновить конфигурацию репозитория, воспользуйтесь инструкцией на странице setup.

При выполнении 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 выводит все сообщения о событиях в консоль.

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

Проверьте:
  1. Настройки Docker:
    • Если вы запускаете ClickHouse в Docker в сети IPv6, убедитесь, что установлено network=host.
  2. Настройки конечной точки.
    • Проверьте настройки listen_host и tcp_port.
    • По умолчанию ClickHouse server принимает подключения только с localhost.
  3. Настройки HTTP-протокола:
    • Проверьте настройки протокола для HTTP API.
  4. Настройки защищённого подключения.
    • Проверьте:
    • При подключении используйте правильные параметры. Например, используйте параметр port_secure с clickhouse_client.
  5. Настройки пользователя:
    • Возможно, вы используете неверное имя пользователя или пароль.

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

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

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

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