Подключение ClickHouse
Содержание
ClickHouse подключается в SubQuery напрямую: запросы выполняются на стороне сервера SubQuery, поэтому база должна быть доступна извне. Подключённый ClickHouse доступен в dbt и в SQL-ячейках ноутбуков.
Что понадобится
- адрес сервера ClickHouse (хост);
- HTTP-порт — по умолчанию 8123;
- имя базы данных;
- пользователь с правами на чтение и, если планируется запись моделей, на создание таблиц;
- доступ к базе по IP: SubQuery обращается к базе с серверов сервиса, разрешите их в настройках ClickHouse.
Создание подключения
- Откройте проект → Подключения → Создать.
- Выберите тип ClickHouse.
- Заполните поля:
| Поле | Значение |
|---|---|
| Название | произвольное имя подключения в проекте |
| Хост | адрес сервера ClickHouse |
| Порт | 8123 (стандартный HTTP-порт) |
| Имя базы данных | имя базы, к которой выполняется подключение |
| Имя пользователя | логин пользователя базы |
| Пароль | пароль пользователя |
- Нажмите Сохранить — SubQuery проверит соединение и подтвердит создание.
Проверка доступа по IP
Самая частая ошибка при подключении ClickHouse — закрытый доступ извне. Если соединение не проходит:
- Убедитесь, что сервер доступен из интернета на указанном порту.
- Разрешите подключения к пользователю с адресов серверов SubQuery.
- Проверьте пароль пользователя и права на базу.
Где использовать подключение
- dbt — подключение станет target-профилем для моделей.
- Ноутбуки — SQL-ячейки будут выполняться на ClickHouse.
- Схема базы появится в дереве dbt и в панели «Схема БД» ноутбука.
Ограничения
- Предпросмотр в dbt и запросы выполняются с лимитами тарифа.
- Реквизиты хранятся в зашифрованном виде, пароль не показывается повторно.