Подключение ClickHouse

ClickHouse подключается в SubQuery напрямую: запросы выполняются на стороне сервера SubQuery, поэтому база должна быть доступна извне. Подключённый ClickHouse доступен в dbt и в SQL-ячейках ноутбуков.

Что понадобится

  • адрес сервера ClickHouse (хост);
  • HTTP-порт — по умолчанию 8123;
  • имя базы данных;
  • пользователь с правами на чтение и, если планируется запись моделей, на создание таблиц;
  • доступ к базе по IP: SubQuery обращается к базе с серверов сервиса, разрешите их в настройках ClickHouse.

Создание подключения

  1. Откройте проект → Подключения → Создать.
  2. Выберите тип ClickHouse.
  3. Заполните поля:
Поле Значение
Название произвольное имя подключения в проекте
Хост адрес сервера ClickHouse
Порт 8123 (стандартный HTTP-порт)
Имя базы данных имя базы, к которой выполняется подключение
Имя пользователя логин пользователя базы
Пароль пароль пользователя
  1. Нажмите Сохранить — SubQuery проверит соединение и подтвердит создание.

Проверка доступа по IP

Самая частая ошибка при подключении ClickHouse — закрытый доступ извне. Если соединение не проходит:

  1. Убедитесь, что сервер доступен из интернета на указанном порту.
  2. Разрешите подключения к пользователю с адресов серверов SubQuery.
  3. Проверьте пароль пользователя и права на базу.

Где использовать подключение

  • dbt — подключение станет target-профилем для моделей.
  • Ноутбуки — SQL-ячейки будут выполняться на ClickHouse.
  • Схема базы появится в дереве dbt и в панели «Схема БД» ноутбука.

Ограничения

  • Предпросмотр в dbt и запросы выполняются с лимитами тарифа.
  • Реквизиты хранятся в зашифрованном виде, пароль не показывается повторно.