JDBC-Treiber-Kompatibilität prüfen

Prev Next

Wenn Sie die Java Runtime auf eine neue Hauptversion aktualisieren (z. B. von OpenJDK 11 auf OpenJDK 21), müssen Sie sicherstellen, dass Ihre JDBC-Datenbanktreiber mit der neuen Java-Version kompatibel sind. Solange Sie Ihre bisherige Java-Version beibehalten, ist eine Aktualisierung der JDBC-Treiber in der Regel nicht erforderlich. Diese Anleitung beschreibt, wie Sie die Kompatibilität prüfen und Treiber bei Bedarf aktualisieren.

Bekanntes Problem mit Microsoft SQL Server

Bei MS SQL Server treten wiederholt Verbindungsfehler auf, wenn der JDBC-Treiber nicht vor einem JDK-Upgrade aktualisiert wird. Wenn Sie auf OpenJDK 21 umsteigen, verwenden Sie mssql-jdbc-12.6.jre21.jar oder neuer. Ältere Versionen — insbesondere Varianten mit dem Suffix jre11 — sind mit OpenJDK 21 nicht mehr kompatibel.

Kein Java-Upgrade geplant?

Wenn Sie Ihre aktuelle Java-Version beibehalten, sind Ihre bestehenden JDBC-Treiber in dr Regel weiterhin kompatibel. Die Schritte in dieser Anleitung sind in diesem Fall nicht notwendig.

Voraussetzungen

  • Sie haben eine Übersicht Ihrer konfigurierten Datenbankverbindungen und der jeweils eingesetzten JDBC-Treiber-Versionen.

  • Sie haben Zugriff auf das Treiberverzeichnis der Lobster Data Platform.

  • Sie können die Plattform neu starten.

  • Sie wissen, auf welche Java-Version Sie aktualisieren (z. B. OpenJDK 21).

Schritt 1 – Eingesetzte JDBC-Treiber ermitteln

  1. Öffnen Sie die Konfiguration Ihrer Datenbankverbindungen in der Lobster Data Platform.

  2. Notieren Sie für jede Verbindung den JDBC-Treiber (Name und Version, z. B. ojdbc11.jar, mssql-jdbc-12.6.jre21.jar) und die Datenbankversion (z. B. Oracle 19c, PostgreSQL 16, SQL Server 2022).

Schritt 2 – Kompatibilität mit der neuen Java-Version prüfen

Konsultieren Sie die Kompatibilitätsmatrix des jeweiligen Treiber-Herstellers. Verwenden Sie den neuesten stabilen Treiber, der Ihre Ziel-Java-Version unterstützt. Die folgende Tabelle enthält Richtwerte für gängige Datenbanken bei einem Upgrade auf OpenJDK 21. Wenn Sie auf eine andere Java-Version aktualisieren, prüfen Sie die jeweilige Herstellerdokumentation entsprechend.

Datenbank

Mindestversion für OpenJDK 21

Herstellerdokumentation

Microsoft SQL Server

mssql-jdbc-12.6.jre21.jar oder höher – Variante jre21 verwenden, nicht jre11.

Microsoft JDBC Support Matrix

Oracle Database

ojdbc11.jar 23.x oder höher

Oracle JDBC Downloads

PostgreSQL

postgresql-42.7.x.jar oder höher. Die aktuelle 42.7.x-Reihe ist die richtige Produktfamilie für die Verwendung mit Java 21.

PostgreSQL JDBC Changelog

MySQL / MariaDB

mysql-connector-j-8.3.x.jar oder höher

MySQL Connector/J Versionen

MariaDB (nativer Treiber)

Aktueller MariaDB Connector/J

MariaDB Connector/J Release Notes

Salesforce (JDBC)

Salesforce-JDBC-Treiber 25.x oder höher setzt Lobster Data Platform 26.2 oder höher voraus. Ältere Plattformversionen werden nicht unterstützt.

Salesforce Driver Online Help

Informix

 HINWEIS Ab 26.2 (sowie 26.1.5 und 25.1.11) nicht als Hub-Datenbank unterstützt. Alle Informix-JARs wurden aus IS/lib entfernt. Für andere Rollen: Treiber selbst bereitstellen und unter IS/extlib  ablegen. Kompatibilität in Staging-Umgebung testen.

IBM Informix JDBC 4.50.JC7 Release Notes

Hinweis

Die oben genannten Treiberversionen sind Richtwerte für ein Upgrade auf OpenJDK 21. Prüfen Sie immer die offizielle Herstellerdokumentation für Ihre konkrete Datenbank- und Java-Kombination.

Schritt 3 – Treiber aktualisieren

Wichtig: Reihenfolge beachten

Aktualisieren Sie die JDBC-Treiber vor dem Java-Upgrade. Wenn Sie zuerst die Java-Version ändern, ohne die Treiber anzupassen, können Datenbankverbindungen fehlschlagen und die Plattform ist möglicherweise nicht funktionsfähig.

  1. Laden Sie die kompatible JDBC-Treiber-Version von der Herstellerseite herunter.

  2. Ersetzen Sie die bestehende .jar-Datei im Treiberverzeichnis der Lobster Data Platform.

  3. Starten Sie die Plattform neu.

Schritt 4 – Verbindungen testen

  1. Öffnen Sie die jeweilige Datenbankverbindung in der Lobster Data Platform.

  2. Führen Sie einen Verbindungstest durch.

  3. Prüfen Sie die Logdateien auf Fehler oder Warnungen im Kontext des JDBC-Treibers.

Best Practice

Führen Sie Treiber-Updates und Java-Upgrades grundsätzlich zuerst in einer Test- oder Staging-Umgebung durch, bevor Sie die Änderungen in die Produktion übernehmen.

Fahren Sie fort mit: JDOM1-zu-JDOM2-Migration