Подключение к базе данных

Здесь описан состав формы подключения к СУБД. Как открыть форму — в разделе Источники данных.

Параметры подключения

Состав полей зависит от типа источника. Для баз данных набор такой:

Поле	Описание
Хост	Адрес сервера базы данных. Платформа обращается к нему со стороны сервера, а не из вашего браузера — адрес должен быть доступен именно серверу
Порт	Порт, по которому платформа подключается к базе
Имя базы данных	База, к которой выполняется подключение
Тип авторизации	«Логин и пароль» либо «Без авторизации»
Пользователь, Пароль	Учётные данные. Достаточно прав только на чтение
SSL	Шифрование соединения и режим проверки сертификата
SSH	Подключение через SSH-туннель, если база недоступна напрямую
Initial SQL	Запрос, который выполняется сразу после подключения
Кастомные параметры	Дополнительные пары «ключ — значение» для драйвера

Порт для ClickHouse

Платформа работает с ClickHouse по HTTP, поэтому нужен HTTP-порт — форма подставляет его сама (8123). Если в вашей установке порт другой, не берите 9000: это порт native-протокола, с ним подключение не установится.

Как хранится пароль

Пароль источника платформа шифрует и кладёт в базу метаданных уже зашифрованным — алгоритмом AES/GCM на ключе, который администратор задаёт при развёртывании (ENCRYPTION_KEY). Тем же ключом шифруется API-ключ AI-провайдера. Отсюда важное для администратора следствие: ключ нужно хранить вместе с резервной копией базы — со сменой ключа ранее сохранённые пароли расшифровать не получится, и источники придётся переподключать.

Особые поля у Oracle

У Oracle вместо «Имя базы данных» — Service Name (например ORCLPDB1) и переключатель Тип подключения:

Вариант	Строка подключения
Service Name	host:port/service — обычный случай
SID	host:port:sid — так подключается, например, Oracle XE

У остальных баз данных состав полей одинаковый: хост, порт, имя базы данных и учётные данные.

Шифрование соединения (SSL)

Раскройте секцию SSL и включите Использовать SSL — появится обязательное поле SSL-режим:

Режим	Что делает
disable	Без шифрования
require	Шифрование обязательно, сертификат не проверяется
verify-ca	Проверяется, что сертификат выдан доверенным центром
verify-full	Дополнительно проверяется совпадение имени хоста с сертификатом

Защищённое соединение обычно слушает другой порт: для ClickHouse это 8443 — платформа подсказывает значение под полем.

Где переключатель SSL действует

Секция SSL показывается у любого типа, но настройки доходят до драйвера у девяти: PostgreSQL, Greenplum, Arenadata DB, CockroachDB, MySQL, MariaDB, StarRocks, ClickHouse и ArenaData QuickMarts. Для остальных типов шифрование задаётся в блоке Кастомные параметры — теми ключами, которые понимает драйвер вашей базы.

Отдельный случай — Microsoft SQL Server: платформа явно передаёт ему encrypt=false. Начиная с десятой версии драйвер включает шифрование сам, и без этого значения любое подключение к MSSQL требовало бы TLS. Нужно шифрование — задайте encrypt=true кастомным параметром, он перекроет значение по умолчанию.

Подключение через SSH-туннель

Если база недоступна напрямую, раскройте секцию SSH и включите Использовать SSH-туннель. Понадобятся адрес и порт промежуточного сервера (по умолчанию 22), имя пользователя и пароль. Платформа поднимет туннель до этого сервера и уже через него пойдёт к базе.

Вход в туннель — только по паролю

Аутентификации по SSH-ключу в текущей версии нет: в форме задаются имя пользователя и пароль. Если политика запрещает парольный вход на промежуточный сервер, туннель придётся поднимать вне платформы и подключаться к нему как к обычному хосту.

Initial SQL

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

SET search_path TO reporting;

Кастомные параметры

Дополнительные пары «ключ — значение», которые передаются драйверу подключения. Нужны для нестандартных настроек конкретной СУБД — например, чтобы включить шифрование там, где секция SSL не действует.

Если драйвер типа не загружен

Часть типов подключается драйвером, который загружает администратор. Пока драйвера нет, это видно ещё на выборе типа: карточка помечена подписью Драйвер не загружен, а в заголовке шага стоит счётчик «Драйвер загружен у N из M». Рядом со счётчиком — переключатель Только доступные: он убирает из списка типы, которые всё равно не подключить. Счётчик и переключатель появляются, только когда хотя бы у одного типа драйвера нет.

Если такой тип всё же выбрать, форма скажет об этом ещё раз: над первым шагом появляется предупреждение «Для этого типа источника не загружен JDBC-драйвер», а кнопки Проверить подключение и Сохранить недоступны — заполнять параметры бессмысленно.

Что делать: выбрать другой тип источника или попросить администратора загрузить .jar в разделе Типы источников и драйверы. Драйвер применяется сразу — после загрузки вернитесь в форму и сохраните источник.

Что дальше

• Не знаете, какой порт подставить, — Справочник типов и портов.
• Форма не даёт сохранить источник из-за драйвера — Типы источников и драйверы.
• Подключение готово — соберите на нём датасет.