Подключения
Содержание
Подключение — это сохранённый доступ к внешней системе: базе данных, рекламному кабинету или хранилищу S3. Подключение создаётся один раз и используется во всех модулях проекта: в потоках, dbt, ноутбуках и файловом менеджере.
Какие бывают подключения
| Тип | Что подключает | Где используется |
|---|---|---|
| ClickHouse | база данных ClickHouse | dbt, ноутбуки |
| PostgreSQL | база данных PostgreSQL | dbt, ноутбуки |
| Greenplum | база данных Greenplum | dbt, ноутбуки |
| Trino | движок запросов Trino | dbt, ноутбуки |
| MySQL | база данных MySQL | dbt, ноутбуки |
| S3 | S3-совместимое хранилище | файловый менеджер, dbt |
| Яндекс Метрика | счётчик Метрики по OAuth | Потоки |
| VK Ads | рекламные кабинеты по OAuth | Потоки |
| DuckDB | Озеро, вычисления в браузере | ноутбуки, dbt |
Страницы по каждому типу — в меню раздела «Подключения».
Как создать подключение
- Откройте проект → раздел Подключения.
- Нажмите Создать и выберите тип.
- Заполните поля формы: для баз данных — хост, порт, имя базы, логин и пароль; для OAuth-источников — пройдите авторизацию.
- Сохраните подключение — оно автоматически проверит соединение.
Реквизиты подключений хранятся в зашифрованном виде: пароли не отображаются участникам, а при редактировании их можно не вводить заново.
Доступ к подключениям
Подключение живёт в проекте, поэтому доступ к нему определяют права в проекте:
- участники проекта видят подключения в дереве схемы и могут выполнять запросы;
- редактирование и удаление доступно участникам с правами на запись;
- для внешних приложений через публичный API доступ проверяется отдельно (см. Публичный API).
Как используется подключение
- Потоки — забирают данные рекламных кабинетов в Озеро (Потоки).
- dbt — подключение становится target-профилем для запуска моделей (Параметры подключения).
- Ноутбуки — SQL-ячейки выполняются на выбранном подключении (Работа с СУБД).
- Файловый менеджер — подключение S3 открывает бакет (Менеджер файлов).
Замена и удаление
Если подключение используется в dbt-проекте или как target, при удалении система предложит заменить его другим подключением — модели и профили переключатся автоматически. Удаление неиспользуемого подключения проходит без предупреждений.