|
Vorwort
HINWEIS Für die Anbindung an Microsoft Fabric gibt es ein separates Tutorial: Microsoft Fabric. Fabric erfordert spezifische Authentifizierung und Verbindungseinstellungen, die über den generischen JDBC-Anbindungsprozess hinausgehen.
Die Lobster Data Platform unterstützt die Anbindung an ca. 30 Datenbanksysteme. Grundsätzlich lässt sich jede relationale Datenbank anbinden, die einen Java-8-kompatiblen JDBC-Treiber mitliefert. Ab Version 4.5 sind auch Java-11-Treiber nutzbar. Seit dem Spring-Release 26.2, auch Java 21.
HINWEIS Ab Version 4.5 lassen sich Datenbanken bequem über die GUI anlegen. Eine Anpassung der Konfigurationsdatei ./etc/database.xml ist nicht mehr nötig. Ein Neustart ist nur nach einem Treiber-Upload erforderlich.
JDBC-Treiber-Download
Im Folgenden wird eine Übersicht über die gebräuchlichsten Treiber für Datenbanksysteme wie MS SQL Server, MySQL, MariaDB, Oracle und PostgreSQL gegeben.
HINWEIS : Neuere Treiberversionen können andere Abhängigkeiten erfordern. Prüfen Sie in diesem Fall die Release Notes des jeweiligen Herstellers/Treibers.
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: HINWEIS Setzen Sie mehrere MS SQL Server unterschiedlicher Versionen ein, wählen Sie einen Treiber, der die Spannweite zwischen niedrigster und höchster Version abdeckt. Es lässt sich nur ein Treiber hinterlegen. |
MySQL | Wenn die JDBC-Treiber-Versionen 8.0.27 und 8.0.28 verwendet werden, sollten diese erneuert werden. | |
MariaDB | Link zum Treiberhersteller für aktuelle Treiberversion https://mariadb.com/kb/en/about-mariadb-connector-j/ | 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 Java-8-kompatiblen JDBC-Treiber. Je nach Oracle-Version 18, 19 oder 21. Treiber-Bezeichnung: ojdbc8.jar |
PostgreSQL | 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 lassen sich ebenso manuell im Verzeichnis ./extlib ablegen. Grundsätzlich gilt: Nur .jar-Dateien dort ablegen (zip wird nicht unterstützt).
Starten Sie den Service neu. Damit der Treiber richtig geladen wird, muss der Integration Server einmal neu gestartet werden. Dies bitte bei der Installation/Inbetriebnahme berücksichtigen.
Prüfen Sie, ob der Treiber korrekt geladen wurde. Zur Startzeit müssten je nach Datenbanksystem und Treiber z. B. folgende Einträge 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 Datenbankverbindung anzulegen.
HINWEIS Sie können die Verbindung direkt aus der Übersicht testen. Klicken Sie mit der rechten Maustaste auf den Eintrag. Wählen Sie im Kontextmenü den Eintrag zum Verbindungstest.
Testen der Datenbankverbindung
Die Verbindung kann über Plugins → SQL Monitor getestet werden.
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.
Wird die Meldung "Keine Einträge gefunden!" angezeigt oder lässt sich ein Select-Statement nicht absetzen (pool exhausted), überprüfen Sie die Verbindungseinstellungen der Datenbank erneut.
Verwandte Themen
Microsoft Fabric: Eigenes Tutorial für die Anbindung an Microsoft Fabric (Cloud-Datenplattform).
Datenbanken/Konnektoren: GUI zur Verwaltung von Datenbankverbindungen und Treibern.
SQL Monitor: Plugin zum Testen einer Datenbankverbindung und zum Absetzen von SQL-Statements.
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.