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: keine eigene C++-Schnittstelle von Microsoft: Schlüssel von ODBC Driver 18 (für bestehende Programme bleibt der ODBC-Treiber der Weg) · Bibliothek ksqlcpp über ksqlkern, CMake-Ziel ksql::ksql (find_package(KuonenKsql)) · C++20, CMake · Quelle: Data/src/Kuonen.Data.Ksql.Cpp · Roadmap D36.6 ✅

Herunterladen und einbinden

• kuonen-ksql-cpp-2.8.0.1-linux-x64.tar.gz · 233 KB

  SHA-256 8cd1596a01b93fe7d5b0455051275073d95a39c757de2640f6e37b93cc91a29d

sudo mkdir -p /opt/ksql && sudo tar -xzf kuonen-ksql-cpp-2.8.0.1-linux-*.tar.gz -C /opt/ksql
# CMakeLists.txt des eigenen Programms:
#   find_package(KuonenKsql CONFIG REQUIRED)
#   target_link_libraries(meinprogramm PRIVATE ksql::ksql)
cmake -S . -B bau -DCMAKE_PREFIX_PATH=/opt/ksql && cmake --build bau

Köpfe und die beiden statischen Bibliotheken (ksqlcpp, ksqlkern) für Linux (x64 oder arm64), gebaut mit g++ und OpenSSL 3; dazu die Paketbeschreibung für find_package.

Aus dem Quellcode bauen

cmake -S Data/src/Kuonen.Data.Ksql.Cpp -B bau [-DKSQL_TLS=openssl|apple|schannel] && cmake --build bau
cmake --install bau --prefix /opt/ksql          # Köpfe, Bibliotheken, find_package(KuonenKsql)
# vcpkg (Overlay-Port) und Conan 2 (Rezept) sind vorbereitet, nicht veröffentlicht:
vcpkg install kuonen-ksql --overlay-ports=Data/src/Kuonen.Data.Ksql.Cpp/verteilung/vcpkg
conan create Data/src/Kuonen.Data.Ksql.Cpp/verteilung/conan --build=missing

Ein Programm bindet ksql::ksql (find_package(KuonenKsql CONFIG REQUIRED)). Die Fassung folgt der des Servers.

Verbindungszeichenfolge

Server=127.0.0.1,1333;UID=sa;PWD={<Ihr-Kennwort>};Encrypt=yes;TrustServerCertificate=yes

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

Beispiel: verbinden, abfragen, Parameter, Transaktion

#include <ksql/ksql.hpp>

auto v = ksql::verbindung::oeffne("Server=127.0.0.1,1333;UID=sa;PWD={…};Encrypt=yes;TrustServerCertificate=yes");
for (const ksql::zeile &z : v.ausfuehren("SELECT id, name FROM kunde WHERE ort = @p1", std::string("Sion")))
    std::cout << z.get<int>(0) << ' ' << z.get<std::optional<std::string>>("name").value_or("-") << '\n';

auto t = v.beginne();
long long n = v.ausfuehren("UPDATE konto SET saldo = saldo - @betrag WHERE id = @id",
                           ksql::param("@betrag", ksql::dezimal("12.50")), ksql::param("@id", 7)).betroffen();
t.bestaetige();                      // ohne bestaetige() nimmt der Zerstörer die Transaktion zurück

try {
    v.ausfuehren("SELECT 1 / 0").zu_ende();
} catch (const ksql::fehler &e) {    // e.nummer() 8134, e.klasse() 16, e.sqlstate() "22012" (am KSQL-Port)
}

Typen

Fehler und SQLSTATE

Unterschiede zu keine eigene C++-Schnittstelle von Microsoft: Schlüssel von ODBC Driver 18 (für bestehende Programme bleibt der ODBC-Treiber der Weg)

• Microsoft liefert keine C++-Schnittstelle; Vorbild sind die Schlüssel von ODBC Driver 18, die Schnittstelle selbst ist eigen (RAII, Ausnahmen, typsichere Parameter, deutsche Namen).
• Ein Fehler des Servers wird an der nächsten Grenze geworfen (Ende der Zeilen, naechste_menge(), zu_ende()); danach lässt sich die Antwort weiterlesen.
• Der Zerstörer liest zu Ende, nimmt die Transaktion zurück und schliesst.

Was fehlt

• Vorbereitete Anweisungen (sp_prepare-Kennung behalten), MARS, Tabellenwertparameter, Always Encrypted.
• Integrierte Anmeldung und Entra ID, eine asynchrone Schnittstelle (Koroutinen), ein Pool.
• Eigene C++-Typen für ARRAY, ROW, MULTISET und INTERVAL.
• Windows (MSVC, SChannel) nicht gebaut; Verteilung nur vorbereitet (kein Register, kein Conan-Remote).

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; TLS kommt wie im Kern aus der Bibliothek des Systems. vcpkg und Conan vorbereitet, nicht veröffentlicht.