Last Update: 17.03.2025

Vorwort

Wir bieten eine Anbindung an ca. 30 Datenbank-Systeme an. Generell kann jede relationale Datenbank angebunden werden, die einen Java8-kompatiblen JDBC-Treiber mitliefert. Ab Version 4.5 können Java11-Treiber verwendet werden.

Hinweis: Ab Version >4.5 können Datenbanken bequem über die GUI angelegt werden. Hierfür ist keine Anpassung der Konfigurationsdatei ./etc/database.xml und kein Neustart mehr notwendig! (Nur nach Treiber-Upload wird ein Neustart benötigt.)

JDBC-Treiber-Download

Folgend eine Übersicht der gängigsten Treiber für Datenbank-Systeme wie MS SQL-Server, MySQL, MariaDB, Oracle, PostgreSQL.

Datenbank	Link	Info
MS SQL	Aktuelle Version: https://docs.microsoft.com/de-de/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server?view=sql-server-ver15 Ältere Versionen: https://docs.microsoft.com/de-de/sql/connect/jdbc/release-notes-for-the-jdbc-driver?view=sql-server-ver15#previous-releases	In der Supportmatrix und Versionskompatibilität findet man die Zuordnung JDBC-Treiber → MS SQL-Server Version: https://docs.microsoft.com/de-de/sql/connect/jdbc/microsoft-jdbc-driver-for-sql-server-support-matrix?view=sql-server-ver15 Hinweis: Hat man mehrere MS SQL-Server unterschiedlicher Versionen im Einsatz, wählen Sie einen Treiber, der die Spannweite zwischen niedrigster Version und höchster Version abdeckt. Es kann nur ein Treiber hinterlegt werden.
MySQL	https://downloads.mysql.com/archives/c-j/	Wenn die JDBC Treiber Versionen 8.0.27 und 8.0.28 verwendet werden, sollten diese erneuert werden.
MariaDB	Aktuelle Version: mariadb-java-client-3.2.0.jar (direkt Link)	Bitte nicht mariadb-java-client-3.2.0-sources.jar, javadoc.jar, sources.jar verwenden!
Oracle	https://www.oracle.com/de/database/technologies/appdev/jdbc-downloads.html	Sie brauchen einen zu ihrer Oracle-Datenbank passenden Java8-kompatiblen JDBC-Treiber. Je nach Oracle Version, 18, 19, 21. Treiber-Bezeichnung: ojdbc8.jar
PostgreSQL	https://jdbc.postgresql.org/download/	In der Installation von Postgres 12 mit dem JDBC-Treiber in der Version 42.2.11 (4.2 für Java 8) kommt es zu Fehlern und der Integration Server lässt sich nicht starten. Abhilfe: JDBC-Treiber in der Version 42.2.10 (4.2 für Java 8) nutzen.
Informix DB	https://mvnrepository.com/artifact/com.ibm.informix/jdbc/4.50.10	Auf der Downloadseite bitte die jar (unter Files) im oberen Bereich downloaden.
Snowflake	https://repo1.maven.org/maven2/net/snowflake/snowflake-jdbc/	Getestet mit Treiber Version 3.9.2 JDBC Connection: https://docs.snowflake.com/en/developer-guide/jdbc/jdbc-configure

Installation des JDBC-Treibers

Ab der Version 4.5 können die Treiber über die GUI (Punkt 1) Verwaltung → Datenbanken/Konnektoren → Treiber verwalten hochgeladen werden.
Die Treiber können ebenso manuell im Verzeichnis ./extlib abgelegt werden. Grundsätzlich gilt: Nur .jar-Dateien dort ablegen (zip wird nicht unterstützt).
Den Service neu starten.
Damit der Treiber richtig geladen wird, muss der Integration Server einmal neu gestartet werden. Dies bitte bei der Installation/Inbetriebnahme berücksichtigen.

Überprüfen, ob der Treiber korrekt geladen wurde.
Zur Startzeit müsste je nach Datenbank-System und Treiber z. B. folgendes im ./logs/wrapper.log stehen.

INFO   | jvm 1    | 2022/08/10 08:53:24 | 178      file:/C:/Lobster/IS/extlib/mssql-jdbc-10.2.0.jre8.jar
INFO   | jvm 1    | 2022/08/10 08:53:24 | 179      file:/C:/Lobster/IS/extlib/mysql-connector-java-8.0.26.jar
INFO   | jvm 1    | 2022/08/10 08:53:24 | 180      file:/C:/Lobster/IS/extlib/ojdbc8.jar

Einrichtung der Datenbankverbindung

Ab der Version 4.5 können Datenbankverbindungen bequem über die GUI angelegt werden.

Durch Rechtsklick, bzw. über den "Plus"-Button auf der rechten, unteren Seite, öffnet sich ein neues Fenster, um eine neue Verbindung hinzuzufügen.
Über Vorlage wählen kann aus verschiedenen Templates/Presets gewählt werden. Wählen Sie das Datenbank-Template aus.
Passen Sie den Inhalt im Feld Database (den Database-String) an, indem Sie DB_HOST_OR_IP und DB_NAME ersetzen.
Füllen Sie bei Bedarf fehlende Felder und JDBC Properties wie z.B. Catalog Name, User, Password, etc. aus.
Klicken Sie abschließend auf Anwenden, um die neue Datenbank-Verbindung anzulegen.

Hinweis: Ein Verbindungstest ist im Kontextmenü der Übersicht möglich!
images/download/attachments/150864779/image-2024-2-19_15-26-32-version-2-modificationdate-1709272351910-api-v2.png

Testen der Datenbankverbindung

Die Verbindung kann über Plugins → SQL Monitor getestet werden.

images/download/attachments/150864779/image-2023-8-7_10-34-48-version-1-modificationdate-1695782554261-api-v2.png

Hierzu wählen Sie aus dem Dropdown-Feld den zuvor angelegten Datenbank-Alias aus.

Ein Klick auf Tables/Procedures sollte eine Übersicht aller verfügbaren Tabellen und Stored Procedures zurückliefern.

images/download/attachments/150864779/image-2023-8-7_10-50-29-version-1-modificationdate-1695782554275-api-v2.png

Wird die Meldung "Keine Einträge gefunden!" angezeigt oder lässt sich ein Select-Statement nicht absetzen (pool exhausted), überprüfen Sie die Datenbank-Verbindungseinstellungen erneut!

Disclaimer

Datenbanken und für den Zugriff auf Datenbanken verwendete JDBC-Treiber sind Produkte von Drittherstellern und werden weder von Lobster unterstützt, noch von Lobster zur Verfügung gestellt. Eine eventuell dennoch geleistete Unterstützung oder Beratung zu Datenbanken bzw. JDBC-Treibern durch den Lobster-Support ist freiwillig und impliziert in keinem Fall einen Übergang der Verantwortung auf diesen. Die Installation, der Betrieb und die Wartung von Datenbanken/JDBC-Treibern, bzw. durchgeführte Maßnahmen an diesen, unterliegen immer und ausnahmslos der Verantwortlichkeit des Kunden.

Der Lobster-Support unterstützt Sie natürlich gerne bei den nötigen internen Konfigurationen zur Anbindung funktionierender Fremdsysteme.