Подключения

Обзор

Раздел Подключения охватывает два вида связи системы с внешними системами:

Подключения к базам данных — сохранённые параметры доступа к внешним базам данных с исходными данными аналитики. Они используются таблицами фактов как физическая основа данных, а витринами — для выполнения сгенерированных SQL-запросов и публикации материализованных представлений. Подключения к базам данных управляются на странице Подключения, которая открывается из главного меню
Подключения к Git — сохранённые параметры доступа к Git-репозиториям, используемым при переносе версий проекта. Они настраиваются в разделе Настройки → Интеграции, на вкладке Подключения к Git

Поддерживаемые типы СУБД

Тип базы данных	Схема	SSL
PostgreSQL	Указывается явно, по умолчанию — `public`	Не настраивается
Microsoft SQL Server	В форме не указывается — используется схема `dbo`	Не настраивается
ClickHouse	В форме не указывается — вместо неё используется название базы данных	CA- и клиентские сертификаты на вкладке SSL

Независимо от типа подключение описывается одним и тем же набором параметров: название подключения, тип базы данных, хост, порт, название базы данных, схема (только для PostgreSQL), имя пользователя и пароль. Учётные данные и сертификаты хранятся в зашифрованном виде.

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

Хранение параметров доступа. Учётные данные, сетевые адреса и SSL-сертификаты внешних баз данных хранятся централизованно в зашифрованном виде
Кеширование схемы базы данных. Список таблиц и колонок с типами данных считывается однократно и сохраняется, что позволяет интерфейсу работать без постоянных обращений к источнику
Выполнение аналитических запросов. Витрины используют подключения для выполнения сгенерированных SQL-запросов и создания представлений непосредственно в целевых базах данных

Контекст версии проекта

Подключения к базам данных относятся к уровню версии проекта: список подключений всегда отображает подключения текущей открытой версии. При создании новой версии подключения родительской версии копируются в неё вместе с SSL-сертификатами.

Подключения к Git, напротив, не версионируются и не привязаны к отдельному проекту: они принадлежат компании и доступны во всех её проектах.

Работа в оффлайн-режиме

После настройки подключения структура базы данных — метаданные таблиц, колонок и их типов — сохраняется в системе. Вся последующая работа в проекте (проектирование таблиц фактов, витрин и показателей) ведётся с этим сохранённым снимком, без постоянного живого подключения к базе данных. Обращение к внешней базе данных выполняется только при проверке подключения, при обновлении его схемы, при выполнении запроса витрины с получением результата и при создании, обновлении или удалении материализованных объектов витрин.

Поэтому изменения в исходной базе данных появляются в интерфейсе только после обновления схемы подключения.

Права доступа

Список подключений видит каждый пользователь, у которого есть доступ к проекту
Проверка подключений и обновление закешированной схемы дополнительно доступны аналитикам
Создание, редактирование, удаление, активация и отключение подключений требуют роли разработчика, менеджера проекта, администратора компании или суперадминистратора
Подключениями к Git управляют только администраторы компании и суперадминистраторы; пользователи с другими ролями могут выбрать существующее подключение к Git в диалогах переноса версий

Все операции с подключениями фиксируются в системном журнале.