Handbuch

Syntax, Datentypen, Funktionen und Fehlernummern je Abfragesprache — jeder Abschnitt mit einem Beispiel aus dem Beispielkatalog und, wo die Sprache einen eigenen Sprachmeilenstein der Roadmap hat, dem Stand jedes einzelnen Punktes daraus.

KSQL ist der Kern von KuonenSQL nach ISO/IEC 9075:2023. Über Port 1333 (voreingestellt aus, Umgebungsvariable KUONENSQL_KSQL_PORT) spricht der Server TDS wie am T-SQL-Port — jeder Treiber für SQL Server verbindet sich (Microsoft.Data.SqlClient, JDBC, go-mssqldb, der eigene Manager) —, nennt in @@VERSION und SERVERPROPERTY aber ehrlich KuonenSQL. Es ist derselbe Datenbestand wie über T-SQL, MariaDB und PostgreSQL: Sperren, Transaktionen und Blockaden gelten über alle Zugänge.

Treiber

Eigene KSQL-Treiber, je nach dem Vorbild des Microsoft-Treibers (D36.8: eine Handbuchseite je Treiber): .NET · Java (JDBC) · TypeScript/JavaScript · C/ODBC · PHP · C++ · Python · Go

Regeln bei Widerspruch zur T-SQL

Wo T-SQL und die Norm verschieden rechnen, gilt am KSQL-Zugang die Norm; wo die Norm die Wahl lässt, bleibt KSQL beim Kern, damit dieselbe Datenbank über jeden Zugang dieselben Werte zeigt. Es gibt keinen Schalter: die Wahl des Zugangs ist die Wahl des Verhaltens.

Merkmale der Norm

Die Merkmalsliste von ISO SQL:2023 steht im Server (INFORMATION_SCHEMA.SQL_FEATURES); jedes unterstützte Merkmal hat eine Probe, die der Testlauf am KSQL-Zugang ausführt.

Beispiele

Typen

SELECT TRUE AS wahr, (1 > 2) AS vergleich, (NULL = 1) IS UNKNOWN AS unbekannt;

wahr | vergleich | unbekannt
True | False | True

Literale

SELECT 0x1F AS zahl, X'1F' AS binaer, 1_000 + 1 AS mit_trenner;

zahl | binaer | mit_trenner
31 | 0x1F | 1001

Abfragen

SELECT n FROM (VALUES (3), (1), (2), (2)) AS t (n)
ORDER BY n OFFSET 1 ROW FETCH FIRST 1 ROW WITH TIES;

n
2
2

WITH RECURSIVE zahlen (n) AS (SELECT 1 UNION ALL SELECT n + 1 FROM zahlen WHERE n < 4)
SELECT SUM(n) AS summe FROM zahlen;

summe
10

Vergleiche

SELECT CASE WHEN NULL IS NOT DISTINCT FROM NULL THEN 'gleich' ELSE 'verschieden' END AS nullen,
       CASE WHEN 1 IS DISTINCT FROM NULL THEN 'verschieden' ELSE 'gleich' END AS eins_null;

nullen | eins_null
gleich | verschieden

Regeln

CREATE TABLE Pruefstand_Eindeutig (Id int PRIMARY KEY, Kennung varchar(10) UNIQUE);
INSERT INTO Pruefstand_Eindeutig VALUES (1, NULL), (2, NULL), (3, 'A');
SELECT COUNT(*) AS zeilen, COUNT(Kennung) AS mit_kennung FROM Pruefstand_Eindeutig;
DROP TABLE Pruefstand_Eindeutig;

zeilen | mit_kennung
3 | 1

Transaktionen

CREATE TABLE Pruefstand_Buchung (Id int PRIMARY KEY, Betrag int);
START TRANSACTION;
INSERT INTO Pruefstand_Buchung VALUES (1, 100);
SAVEPOINT vor_fehler;
INSERT INTO Pruefstand_Buchung VALUES (2, 999);
ROLLBACK TO SAVEPOINT vor_fehler;
COMMIT;
COMMIT;
SELECT Id, Betrag FROM Pruefstand_Buchung;
DROP TABLE Pruefstand_Buchung;

Id | Betrag
1 | 100

Kennung

SELECT LEFT(@@VERSION, 9) AS produkt, CAST(SERVERPROPERTY('Edition') AS nvarchar(20)) AS ausgabe;

produkt | ausgabe
KuonenSQL | KuonenSQL