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: ODBC Driver 18 for SQL Server · libksqlodbc (ODBC 3.8) auf dem Protokollkern libksqlkern (C11) · CMake; Linux mit unixodbc-dev und libssl-dev, Windows mit dem SDK (SChannel), macOS mit Secure Transport und den Köpfen von unixODBC oder iODBC · Quelle: Data/src/Kuonen.Data.Ksql.Odbc, Data/src/Kuonen.Data.Ksql.C · Roadmap D36.5 ✅

Herunterladen und einbinden

• kuonen-ksql-odbc-2.8.0.1-linux-x64.tar.gz · 108 KB

  SHA-256 c10d90a442832aca382b51895ce39f9138eaf507c09a0c993d541d7779a5132c

sudo mkdir -p /opt/ksql && sudo tar -xzf kuonen-ksql-odbc-2.8.0.1-linux-*.tar.gz -C /opt/ksql
printf '[Kuonen KSQL ODBC Driver]\nDriver=/opt/ksql/libksqlodbc.so\nThreading=0\n' | sudo tee -a /etc/odbcinst.ini
# Verbindung: DRIVER={Kuonen KSQL ODBC Driver};Server=…,1333;…

Der ODBC-Treiber als Bibliothek für Linux, x64 oder arm64 je nach Server (unixODBC, OpenSSL 3). Für Windows und macOS gibt es noch keinen Download (D36.5e).

Aus dem Quellcode bauen

cmake -S Data/src/Kuonen.Data.Ksql.Odbc -B bau -DCMAKE_BUILD_TYPE=Release && cmake --build bau

# odbcinst.ini (Linux)
[Kuonen KSQL ODBC Driver]
Driver=/pfad/libksqlodbc.so
Threading=0

Threading=0, damit SQLCancel aus einem zweiten Faden am Treibermanager vorbeikommt. Der Kern allein: cmake -S Data/src/Kuonen.Data.Ksql.C -B bau [-DKSQL_TLS=openssl|apple|schannel] ergibt libksqlkern.a.

Verbindungszeichenfolge

Driver={Kuonen KSQL ODBC Driver};Server=tcp:localhost,1333;UID=sa;PWD=<Ihr-Kennwort>;TrustServerCertificate=yes

Ohne Port gilt 1433 wie beim Vorbild; den KSQL-Port 1333 nennt man.

Beispiel: verbinden, abfragen, Parameter, Transaktion

SQLDriverConnect(dbc, NULL, (SQLCHAR *)"Driver={Kuonen KSQL ODBC Driver};Server=tcp:localhost,1333;"
                 "UID=sa;PWD=…;TrustServerCertificate=yes", SQL_NTS, NULL, 0, NULL, SQL_DRIVER_NOPROMPT);
SQLSetConnectAttr(dbc, SQL_ATTR_AUTOCOMMIT, (SQLPOINTER)SQL_AUTOCOMMIT_OFF, 0);

SQLAllocHandle(SQL_HANDLE_STMT, dbc, &st);
SQLPrepare(st, (SQLCHAR *)"SELECT name FROM sys.tables WHERE name LIKE ?", SQL_NTS);
SQLCHAR muster[] = "kk_%"; SQLLEN laenge = SQL_NTS;
SQLBindParameter(st, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_VARCHAR, 64, 0, muster, 0, &laenge);
SQLExecute(st);
while (SQL_SUCCEEDED(SQLFetch(st))) { /* SQLGetData … */ }
SQLCloseCursor(st);
SQLEndTran(SQL_HANDLE_DBC, dbc, SQL_COMMIT);

if (SQLExecDirect(st, (SQLCHAR *)"SELECT 1 / 0", SQL_NTS) == SQL_ERROR) {
    SQLCHAR zustand[6], text[512]; SQLINTEGER nummer;   /* zustand "22012", nummer 8134 */
    SQLGetDiagRec(SQL_HANDLE_STMT, st, 1, zustand, &nummer, text, sizeof text, NULL);
}

Typen

Fehler und SQLSTATE

Unterschiede zu ODBC Driver 18 for SQL Server

• Dieselben Verbindungsschlüssel, SQLGetInfo, Typabbildung und Massenkopie (bcp_initA/W, bcp_bind, bcp_sendrow, bcp_batch, bcp_done …) wie ODBC Driver 18.
• MARS_Connection=yes gibt einen Hinweis (01S00), die Verbindung arbeitet ohne MARS.
• Parameterfelder gehen Satz für Satz als eigene Anfrage (der Microsoft-Treiber bündelt sie in einen Stapel).
• Der Savepoint geht über SAVE TRANSACTION im Stapel (ODBC hat keine Funktion dafür).
• Eigene Erweiterung SQL_CA_KSQL_SERVERTYP für money/datetime-Parameter.
• Der Protokollkern libksqlkern trägt zugleich die PHP-Erweiterung und die C++-Schnittstelle.

Was fehlt

• Scrollbare Cursor, asynchrone Ausführung, SQLSetPos/SQLBulkOperations, SQLBrowseConnect, eigene Deskriptoren und SQLCopyDesc.
• MARS, Always Encrypted, Tabellenwertparameter, bcp mit Dateien, Windows- und Entra-Anmeldung.
• Andere Codepages als 1252 und UTF-8 bei char/varchar; Daten bei der Ausführung in Parameterfeldern, SQL_ATTR_PARAM_BIND_OFFSET_PTR.
• Nicht gelaufen: Windows (nur mit mingw-w64 übersetzt), macOS mit dem Treiber (nur der Kern).

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.

Eigener Code ohne fremde Quellen; fremd sind nur der Treibermanager (unixODBC, iODBC oder der von Windows) und die TLS-Bibliothek des Systems.