Оформление
Типы источников и драйверы
Раздел Типы источников определяет, к каким системам пользователи смогут подключаться. Доступен администратору.
Состав справочника
| Колонка | Что означает |
|---|---|
| Название | Как тип называется в мастере подключения |
| Код | Внутренний идентификатор — clickhouse, pgsql, mysql и так далее |
| Порт | Порт, который подставляется в форму подключения по умолчанию |
| Статус | Активен тип или скрыт от пользователей |
| Драйвер | Загруженный JDBC-драйвер, если он нужен |
В поставке 23 типа: 20 баз данных и хранилищ, объектное хранилище «S3», «Файл» и «OData (1С)». У файловых типов и OData порт не указывается: у первых его нет, у второго адрес публикации задаётся целиком одной строкой.
JDBC-драйверы
Из 23 типов справочника три не используют JDBC — «Файл», «S3» и «OData (1С)». Остальные двадцать делятся на две группы: девять типов работают сразу, одиннадцать требуют загруженного драйвера.
Сторонние драйверы не входят в поставку, чтобы их уязвимости не попадали в платформу. Администратор сам решает, какую версию драйвера загрузить и когда её обновить.
Работают сразу
В поставку входят четыре драйвера, и каждый обслуживает несколько типов:
| Драйвер в сборке | Какие типы закрывает |
|---|---|
| PostgreSQL | PostgreSQL, Greenplum, Arenadata DB, CockroachDB |
| MySQL Connector/J | MySQL, StarRocks |
| MariaDB Connector/J | MariaDB |
| ClickHouse JDBC | ClickHouse, ArenaData QuickMarts |
Здесь ничего загружать не нужно: источник такого типа читает данные сразу после создания.
Требуют загрузки драйвера
Одиннадцать типов требуют загруженного драйвера. Файлов при этом девять: Firebird и Red работают на одном Jaybird, Apache Hive и Apache Spark — на одном hive-jdbc.
В таблице указаны версии, совместимые с текущим выпуском платформы. Каждый файл доступен по ссылке.
| Тип источника | Драйвер | Размер |
|---|---|---|
| Oracle | ojdbc11-23.26.3.0.0.jar | 7,4 МБ |
| Microsoft SQL Server | mssql-jdbc-13.4.0.jre11.jar | 1,5 МБ |
| Vertica | vertica-jdbc-25.3.0-0.jar | 1,8 МБ |
| Firebird, Red | jaybird-6.0.5.jar | 1,5 МБ |
| H2 | h2-2.4.240.jar | 2,6 МБ |
| Trino | trino-jdbc-483.jar | 10,0 МБ |
| Presto | presto-jdbc-0.298.1.jar | 14,6 МБ |
| Amazon Redshift | redshift-jdbc42-2.2.8.jar | 1,1 МБ |
| Apache Hive, Apache Spark | hive-jdbc-4.2.0-standalone.jar | 46,3 МБ |
Классы драйверов и координаты Maven — если нужна другая версия
По классу проверяют JAR, загруженный из другого источника: класс должен быть внутри архива, иначе платформа ответит «Failed to load driver class».
- Oracle —
oracle.jdbc.OracleDriver,com.oracle.database.jdbc:ojdbc11:23.26.3.0.0 - Microsoft SQL Server —
com.microsoft.sqlserver.jdbc.SQLServerDriver,com.microsoft.sqlserver:mssql-jdbc:13.4.0.jre11 - Vertica —
com.vertica.jdbc.Driver,com.vertica.jdbc:vertica-jdbc:25.3.0-0 - Firebird, Red —
org.firebirdsql.jdbc.FBDriver,org.firebirdsql.jdbc:jaybird:6.0.5 - H2 —
org.h2.Driver,com.h2database:h2:2.4.240 - Trino —
io.trino.jdbc.TrinoDriver,io.trino:trino-jdbc:483 - Presto —
com.facebook.presto.jdbc.PrestoDriver,com.facebook.presto:presto-jdbc:0.298.1 - Amazon Redshift —
com.amazon.redshift.jdbc42.Driver,com.amazon.redshift:redshift-jdbc42:2.2.8 - Apache Hive, Apache Spark —
org.apache.hive.jdbc.HiveDriver,org.apache.hive:hive-jdbc:4.2.0:standalone
Все артефакты лежат в Maven Central. Путь строится из координат: группа с точками превращается в каталоги, дальше имя, версия и файл <имя>-<версия>.jar. Для Oracle это https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc11/23.26.3.0.0/. Более свежая версия обычно тоже подходит, если в архиве есть нужный класс.
Пока драйвера нет, источник такого типа не сохранить
Мастер подключения проверяет драйвер до сохранения: в шаге Параметры подключения появляется предупреждение, а кнопки Проверить подключение и Сохранить недоступны. Загружайте драйверы для нужных типов заранее — как выглядит предупреждение, показано в разделе Подключение к базе данных.
Как загрузить драйвер
- Скачайте нужный
.jar— из таблицы выше или из Maven Central. - Щёлкните по названию типа в списке — откроется окно Редактировать тип источника.
- Перетащите файл
.jarв поле JDBC-драйвер или выберите его на диске. - Нажмите Сохранить.
Имя загруженного файла появится в колонке Драйвер — по нему видно и сам факт загрузки, и версию.
Перезапуск не нужен
Драйвер применяется сразу: источник, который до загрузки отвечал ошибкой «Failed to load driver class», начинает отдавать схему и данные сразу после сохранения. Перезапускать платформу не требуется.
Чтобы удалить драйвер, откройте ту же карточку типа и удалите файл: тип останется в списке, но источники на нём снова начнут отвечать ошибкой загрузки класса, а новые источники этого типа перестанут сохраняться.
В том же окне правятся название, порт по умолчанию и переключатель Активен. Код типа задаётся только при создании и дальше не меняется — в карточке он показан, но недоступен для правки.
Отключение, добавление и удаление типов
Ненужный тип переводится в неактивные переключателем Активен: он исчезает из мастера подключения, а созданные на нём источники продолжают работать.
Кнопка Создать тип добавляет свой тип подключения: название, код латиницей (pgsql, mysql, clickhouse), порт по умолчанию и файл драйвера.
Удалить можно только тип, на котором нет источников: платформа отвечает «Нельзя удалить тип, который используется в источниках». Удаление необратимо — сначала переведите тип в неактивные и убедитесь, что он никому не нужен.
Проверьте порт по умолчанию
Значение из колонки Порт подставляется в форму подключения как есть, а в вашей инсталляции база может слушать другой порт. Если пользователи жалуются, что подключение не проходит, начните проверку отсюда. Значения по умолчанию перечислены в разделе Справочник типов и портов.
Что дальше
- Подключение к базе данных — как аналитик заведёт источник после загрузки драйвера.
- Справочник типов и портов — что и на каком порту искать.