KSQL-Treiber

Eigene Treiber für den KSQL-Port (TDS 7.4 mit dem KSQL-Profil) in acht Sprachen, je nach dem Vorbild des Microsoft-Treibers: dieselbe Schnittstelle, dieselben Schlüssel der Verbindungszeichenfolge, dieselbe Abbildung der Typen und Fehler — und dazu, was KSQL über SQL Server hinaus kann. Jeder arbeitet auch an SQL Server. Jeder Treiber spielt denselben sprachneutralen Prüfkatalog ab (KuonenSQL/tools/ksql-konformitaet/faelle.json, D36.1), einmal gegen den KSQL-Port und einmal gegen SQL Server 2025.

Vorbild: mssql-jdbc · Maven org.kuonen.ksql:kuonen-ksql-jdbc, Paket org.kuonen.ksql.jdbc · Java 17+, JDBC 4.3 · Quelle: Data/src/Kuonen.Data.Ksql.Java, Data/src/Kuonen.Data.Ksql.Java.Flyway · Roadmap D36.2 ✅

Herunterladen und einbinden

• kuonen-ksql-jdbc-2.0.0.jar · 185 KB

  SHA-256 12a58b423d8f3d4712c27f4dbefb7531613aff10fd6a6acd6ade045b0081af62

# Maven: ins lokale Repository übernehmen, dann als Abhängigkeit org.kuonen.ksql:kuonen-ksql-jdbc:2.0.0
mvn install:install-file -Dfile=kuonen-ksql-jdbc-2.0.0.jar -DgroupId=org.kuonen.ksql -DartifactId=kuonen-ksql-jdbc -Dversion=2.0.0 -Dpackaging=jar
# Gradle: implementation(files("libs/kuonen-ksql-jdbc-2.0.0.jar"))
# ohne Werkzeug:
java -cp kuonen-ksql-jdbc-2.0.0.jar:. MeinProgramm

Ein JAR ohne Abhängigkeiten (Java 17+); es meldet sich selbst bei DriverManager an, die URL beginnt mit jdbc:ksql:. Die Flyway-Erweiterung gibt es nur aus dem Quellcode.

Aus dem Quellcode bauen

cd Data/src/Kuonen.Data.Ksql.Java && mvn install      # org.kuonen.ksql:kuonen-ksql-jdbc
sh Data/src/Kuonen.Data.Ksql.Java/pruefen.sh          # ohne Maven: nur javac und jar aus dem JDK 17+, mit den eigenen Prüfungen
cd Data/src/Kuonen.Data.Ksql.Java.Flyway && mvn install   # org.kuonen.ksql:kuonen-ksql-flyway (nur für Flyway)

Ohne Fremdabhängigkeiten; der Treiber meldet sich über META-INF/services bei java.sql.DriverManager an. Für Flyway 10 gibt es die Erweiterung kuonen-ksql-flyway (eigenes JAR neben dem Treiber, D36.8a): sie meldet über META-INF/services den Datenbanktyp „KuonenSQL“ für jdbc:ksql: an, setzt auf flyway-sqlserver auf und lässt die Engine Edition 100 zu; Flyway bringt die Anwendung mit, der Treiber selbst bleibt ohne Abhängigkeiten. Spring JDBC (D36.8g) kennt den Produktnamen „KuonenSQL“ nicht: für die Übersetzung der Fehlernummern die Vorlage Data/src/Kuonen.Data.Ksql.Java/spring/sql-error-codes.xml als sql-error-codes.xml in den Klassenpfad der Anwendung legen (oder ihre Bean in eine vorhandene übernehmen); SimpleJdbcCall liest die Parameter einer Prozedur nur bei Produkten, die Spring kennt, darum mit withoutProcedureColumnMetaDataAccess() und erklärten Parametern (declareParameters) aufrufen. Ein README hat der Treiber nicht; die Angaben stammen aus dem Code und der Roadmap-Zeile D36.2.

Verbindungszeichenfolge

jdbc:ksql://localhost;databaseName=master;user=sa;password=<Ihr-Kennwort>;encrypt=true;trustServerCertificate=true

Ohne Port gilt 1333 (der KSQL-Port).

Beispiel: verbinden, abfragen, Parameter, Transaktion

import java.sql.*;

try (Connection c = DriverManager.getConnection(
        "jdbc:ksql://localhost;databaseName=master;encrypt=true;trustServerCertificate=true", "sa", "…")) {
    c.setAutoCommit(false);
    try (PreparedStatement s = c.prepareStatement("SELECT name FROM sys.tables WHERE name LIKE ?")) {
        s.setString(1, "kk_%");
        try (ResultSet r = s.executeQuery()) {
            while (r.next()) System.out.println(r.getString(1));
        }
    }
    Savepoint vorher = c.setSavepoint("vorher");
    c.commit();

    try (Statement s = c.createStatement()) {
        s.executeQuery("SELECT 1 / 0");
    } catch (SQLException e) {          // e.getErrorCode() 8134, e.getSQLState() "22012"
        System.out.println(e.getErrorCode() + " " + e.getSQLState());
    }
}

Typen

Fehler und SQLSTATE

Unterschiede zu mssql-jdbc

• URL jdbc:ksql:// statt jdbc:sqlserver://, dieselben Schlüssel; Vorgabeport 1333 statt 1433.
• Klassen mit den Namen von mssql-jdbc (SQLServerDriver, SQLServerDataSource, SQLServerBulkCopy, ISQLServerBulkData …) unter dem eigenen Paket org.kuonen.ksql.jdbc.
• DatabaseMetaData über sp_tables, sp_columns, sp_pkeys usw. mit denselben Spalten in derselben Reihenfolge und denselben Typen wie mssql-jdbc (D36.2a an SQL Server 2025 gemessen: getTables mit fünf Spalten, getColumns mit den SS_-Zusatzspalten, getFunctions über sp_stored_procedures).
• Am KSQL-Port zusätzlich SQLSTATE der Norm, BOOLEAN, INTERVAL, DECFLOAT, ROW/ARRAY/MULTISET mit den Typnamen der Norm.
• Unter TLS geht jedes Paket in genau einem Record (höchstens 16 384 Bytes, unter TLS 1.3 16 367) – SQL Server schliesst sonst die Verbindung.

Was fehlt

• MARS, rollbare und änderbare Ergebnismengen, Clob/Blob/SQLXML als Objekte.
• Always Encrypted, Tabellenwertparameter, integrierte Anmeldung und Entra ID, XA.
• TDS 8 am Orakel (am KSQL-Port und mit einem TLS-Spielserver geprüft).
• Verteilung über Maven Central.

Herkunft und Lizenz

Eigenbau: übernommen sind nur die Schnittstelle des Microsoft-Treibers und das am Orakel (SQL Server 2025) gemessene Verhalten, kein Code – auch nicht aus MIT- oder BSD-lizenzierten Quellen –, damit der Treiber uneingeschränkt KuonenSQL gehört. Der Code bleibt geschlossen; eine Veröffentlichung gibt es nur als eigenständigen Fork, den Marc Kuonen selbst anlegt.

Rund 11 500 Zeilen eigener Code, TDS 7.4 samt TLS im PRELOGIN selbst; ohne Fremdabhängigkeiten. Nicht auf Maven Central.