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: Microsoft.Data.SqlClient · Kuonen.Data.Ksql (Namensraum Kuonen.Data.Ksql), auf dem eigenen TDS-Treiber Kuonen.Data.Tds · .NET 10, AOT-tauglich · Quelle: Data/src/Kuonen.Data.Ksql · Roadmap K33.17 ✅

Herunterladen und einbinden

• Kuonen.Data.Gemeinsam.2.8.1.nupkg · 29 KB

  SHA-256 8970bbedd6260f0b1d29c5a9e58b458602c737e52fdc223fb20e6fbcd9c58f35

• Kuonen.Data.Ksql.2.8.1.nupkg · 61 KB

  SHA-256 0f03e8312f6717ab0f782a3f843ac2ae823daea3fd4b1d6df7986e671bfd3ca7

• Kuonen.Data.Tds.2.8.1.nupkg · 230 KB

  SHA-256 87a945aa6e9ae03dee96652c2b448639d3722e2cf57aef0585a8a1e9cd0e2616

# die drei .nupkg in einen Ordner legen, etwa ./ksql-pakete
dotnet nuget add source ./ksql-pakete --name kuonen-ksql
dotnet add package Kuonen.Data.Ksql --version 2.8.1

Kuonen.Data.Ksql braucht Kuonen.Data.Tds und dieses Kuonen.Data.Gemeinsam – alle drei Pakete gehören in denselben Ordner. Danach wie im Beispiel unten: using Kuonen.Data.Ksql;

Aus dem Quellcode bauen

dotnet build Data/src/Kuonen.Data.Ksql
# im eigenen Projekt:
# <ProjectReference Include="…/Data/src/Kuonen.Data.Ksql/Kuonen.Data.Ksql.csproj" />

Aus dem Quellcode wird der Treiber als Projektverweis eingebunden (Kuonen.Data.Ksql.csproj) und zieht Kuonen.Data.Tds mit; gebaut gibt es ihn oben als NuGet-Paket. Ein README hat der Treiber nicht; die Angaben stammen aus dem Code und der Roadmap-Zeile K33.17.

Verbindungszeichenfolge

Server=localhost;Database=master;User ID=sa;Password=<Ihr-Kennwort>;TrustServerCertificate=True

Ohne Port gilt 1333 (der KSQL-Port).

Beispiel: verbinden, abfragen, Parameter, Transaktion

using Kuonen.Data.Ksql;

await using var verbindung = new KsqlConnection("Server=localhost;User ID=sa;Password=…;TrustServerCertificate=True");
await verbindung.OpenAsync();                      // ohne Port gilt 1333

await using var transaktion = await verbindung.BeginTransactionAsync();
await using var befehl = new KsqlCommand("SELECT name FROM sys.tables WHERE name LIKE @muster", verbindung, transaktion);
befehl.Parameters.Add(new KsqlParameter("@muster", "kk_%"));
await using (var leser = await befehl.ExecuteReaderAsync())
{
    while (await leser.ReadAsync())
        Console.WriteLine(leser.GetString(0));
}
transaktion.Save("vorher");                        // SAVEPOINT vorher
await transaktion.CommitAsync();

try
{
    await new KsqlCommand("SELECT 1 / 0", verbindung).ExecuteScalarAsync();
}
catch (KsqlException fehler)                       // fehler.Number 8134, fehler.SqlState "22012"
{
    Console.WriteLine($"{fehler.Number} {fehler.SqlState}");
}

Typen

Fehler und SQLSTATE

Unterschiede zu Microsoft.Data.SqlClient

• Klassen KsqlConnection, KsqlCommand, KsqlParameter, KsqlDataReader, KsqlTransaction, KsqlProviderFactory statt Sql…; KsqlException erbt von TdsException, nicht von SqlException.
• Vorgabeport 1333 statt 1433 (KsqlConnectionStringBuilder.WithDefaultPort).
• Ehrliche Kennung: ServerVersion ist die Fassung von KuonenSQL, ServerProgramName „KuonenSQL“, IsKsql sagt, ob die Verbindung am KSQL-Port hängt.
• Transaktionen nach der Norm: Sicherungspunkte über SAVEPOINT, ROLLBACK TO SAVEPOINT und RELEASE SAVEPOINT, BeginTransaction(isolationLevel, readOnly: true) für READ ONLY (eine Änderung darin ist 3906, SQLSTATE 25006).
• GetSchema("INFORMATION_SCHEMA.<SICHT>") mit den Spalten der Norm.
• CALL mit OUT/INOUT und GET DIAGNOSTICS in Routinen.

Was fehlt

• DbBatch mit den Typen der Norm (KsqlBatch; heute liefert der TdsBatch Text).
• GetColumnSchema mit den Typnamen der Norm.
• BOOLEAN mit eigenem Typnamen auf der Leitung (heute bit) – Entscheid über das Profil nötig.

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.

Aufgesetzt auf den eigenen TDS-Treiber Kuonen.Data.Tds des Managers, unabhängig von Microsoft.Data.SqlClient; kein NuGet-Paket.