Подключения

Подключение — это сохранённый доступ к внешней системе: базе данных, рекламному кабинету или хранилищу 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

Страницы по каждому типу — в меню раздела «Подключения».

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

  1. Откройте проект → раздел Подключения.
  2. Нажмите Создать и выберите тип.
  3. Заполните поля формы: для баз данных — хост, порт, имя базы, логин и пароль; для OAuth-источников — пройдите авторизацию.
  4. Сохраните подключение — оно автоматически проверит соединение.

Реквизиты подключений хранятся в зашифрованном виде: пароли не отображаются участникам, а при редактировании их можно не вводить заново.

Доступ к подключениям

Подключение живёт в проекте, поэтому доступ к нему определяют права в проекте:

  • участники проекта видят подключения в дереве схемы и могут выполнять запросы;
  • редактирование и удаление доступно участникам с правами на запись;
  • для внешних приложений через публичный API доступ проверяется отдельно (см. Публичный API).

Как используется подключение

  • Потоки — забирают данные рекламных кабинетов в Озеро (Потоки).
  • dbt — подключение становится target-профилем для запуска моделей (Параметры подключения).
  • Ноутбуки — SQL-ячейки выполняются на выбранном подключении (Работа с СУБД).
  • Файловый менеджер — подключение S3 открывает бакет (Менеджер файлов).

Замена и удаление

Если подключение используется в dbt-проекте или как target, при удалении система предложит заменить его другим подключением — модели и профили переключатся автоматически. Удаление неиспользуемого подключения проходит без предупреждений.