Драйвера JDBC для доступа к данным
На текущий момент(версия 8) Luxms BI поставляется со следующим набором JDBC для доступа к Источникам данных
:
- PostgreSQL, v42.2.5
- Clickhouse, v0.2.4
- SQLserver, v7.0.0
- Oracle, v12.2.0.1
- Oracle, v19.9.0.0
- Mysql, v5.1.47
- Linter, v1.8
- SQLite, v3.20.1
- Olap4j, v1.1.0
- Hive2, v3.1.2
- Teradata, v16.20.0.13
Список драйверов может быть расширен и версии драйверов могут быть обновлены в дальнейшем. Для уточнения используемых в Вашей инсталяции драйверов необходима проверка установленных драйверов. Ниже описано настройка и месторасположение в файловой системе, которое подлежит проверкею
Подключение дополнительных драйверов
Драйвера JDBC используются компонентами luxmsbi-importer
и luxmsbi-datagate
. Расположение драйверов JDBC в папках файловой системы, определяется параметром конфигурации компонента(/opt/luxmsbi/config/[Имя Компонента]/application.properties):
luxmsbi.drivers-config.location=/opt/luxmsbi/lib/jdbc
Требования к настройке драйверов JDBC:
-
Имя папок должно соответсвовать следующим правилам: [Vendor name]_[Major version]_[Minor version],
где
Vendor name
- должно совпадать с именем используемым в url, для подключения к источнику данных.
Например: /opt/luxmsbi/lib/jdbc/mysql_5_1/
- Каждая папка драйвера должна содержать:
- набор JAR-файлов драйвера;
- файл описания
info.json
, в формате JSON.
- Формат файла описания
info.json
, например для MariaDB:
{"vendor":"mysql","majorVersion":5,"minorVersion":1,"className":"com.mysql.jdbc.Driver","config":{}}
Элемент “config” может содержать перечень свойств, поддерживаемых конкретным драйвером, включая свойства конфигурации пула соединений, например:
- max-pool-size;
- timeout;
- и прочие.
- Владелец и права на папку драйвера, содержащиеся в ней файлы, должны быть следующие:
[root@host ~]# ls -la /opt/luxmsbi/lib/jdbc/mysql_5_1/
total 1004
drwxrwx---. 2 bi bi 62 Jun 2 04:00 .
drwxrwx---. 11 bi bi 12288 Jun 1 11:05 ..
-rw-r-----. 1 bi bi 100 Jun 1 11:04 info.json
-rw-r-----. 1 bi bi 1007502 Jun 1 11:04 mysql-connector-java-5.1.47.jar
Добавление драйверов требует перезапуска компонентов:
sudo systemctl restart luxmsbi-datagate luxmsbi-importer