Типы источников и драйверы

Раздел Типы источников определяет, к каким системам пользователи смогут подключаться. Доступен администратору.

Состав справочника

Колонка	Что означает
Название	Как тип называется в мастере подключения
Код	Внутренний идентификатор — clickhouse, pgsql, mysql и так далее
Порт	Порт, который подставляется в форму подключения по умолчанию
Статус	Активен тип или скрыт от пользователей
Драйвер	Загруженный JDBC-драйвер, если он нужен

В поставке 22 типа: 19 баз данных, объектное хранилище Amazon Redshift, а также «Файл» и «S3». У файловых типов порт не указывается.

Отключение и добавление типов

Ненужный тип можно перевести в неактивные — он исчезнет из мастера подключения, а уже созданные источники продолжат работать. Кнопка Создать тип добавляет новый тип подключения.

JDBC-драйверы

Драйверы четырёх семейств встроены в платформу и работают сразу: PostgreSQL (вместе с Greenplum, Arenadata DB и CockroachDB), MySQL, MariaDB и ClickHouse (вместе с ArenaData QuickMarts). Остальные загружает администратор — и это сделано намеренно.

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

Пока драйвера нет, источник создаётся, но не читается

Мастер подключения не проверяет наличие драйвера: источник сохранится без предупреждений, а при первом обращении к данным пользователь получит ошибку вида «Failed to load driver class oracle.jdbc.OracleDriver». Загрузите драйверы для нужных типов заранее.

Как загрузить драйвер

1. Скачайте JDBC-драйвер нужной базы — обычно с сайта производителя или из репозитория Maven Central. Для Oracle это артефакт ojdbc11.
2. В строке типа откройте меню и выберите Редактировать.
3. Перетащите файл .jar в поле JDBC-драйвер или выберите его на диске.
4. Нажмите Сохранить.

Имя загруженного файла появится в колонке Драйвер — по нему видно и сам факт загрузки, и версию.

Перезапуск не нужен

Драйвер подхватывается на лету. Проверено: сразу после загрузки ojdbc11 источник Oracle, который до этого отвечал ошибкой, начал отдавать список схем и данные таблиц — платформу перезапускать не пришлось.

В том же окне правятся название, код типа, порт по умолчанию и переключатель Активен.

Проверьте порт по умолчанию

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