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.

Über Port 4000 (Empfehlung; voreingestellt aus) spricht KuonenSQL GraphQL über HTTP(S): das Schema wächst aus dem Katalog (Tabellen, Sichten, Funktionen, Fremdschlüssel in beide Richtungen), Mutationen sind Transaktionen, Abonnements laufen als Live-Abfragen über WebSocket — alles auf demselben Datenbestand wie T-SQL. Der Server liefert unter /graphql auch eine eigene Oberfläche zum Ausprobieren. Die Beispiele setzen zwei Tabellen voraus; ihr Text steht am Anfang des ersten Beispiels (in T-SQL ausführen).

Beispiele

CREATE TABLE pruefstand_kunden (Id INT IDENTITY(1,1) PRIMARY KEY, Name NVARCHAR(50) NOT NULL, Ort NVARCHAR(50) NULL);
CREATE TABLE pruefstand_bestellungen (
    Id INT IDENTITY(1,1) PRIMARY KEY, KundeId INT NOT NULL, Betrag DECIMAL(10,2) NOT NULL,
    CONSTRAINT fk_pruefstand_bestellungen_kunden FOREIGN KEY (KundeId) REFERENCES pruefstand_kunden(Id));
INSERT INTO pruefstand_kunden (Name, Ort) VALUES ('Anna', 'Bern'), ('Bruno', 'Zürich'), ('Clara', 'Bern');
INSERT INTO pruefstand_bestellungen (KundeId, Betrag) VALUES (1, 10.00), (1, 20.50), (2, 5.25);

Abfragen

{ pruefstand_kunden(where: {Ort: {eq: "Bern"}}, orderBy: [{Name: DESC}]) { Id Name Ort } }

Antwort
{"pruefstand_kunden":[{"Id":"3","Name":"Clara","Ort":"Bern"},{"Id":"1","Name":"Anna","Ort":"Bern"}]}

{ pruefstand_kunden(distinct_on: [Ort], orderBy: [{Ort: ASC}, {Id: ASC}]) { Ort Name } }

Antwort
{"pruefstand_kunden":[{"Ort":"Bern","Name":"Anna"},{"Ort":"Zürich","Name":"Bruno"}]}

Verschachtelung

{ pruefstand_kunden(orderBy: [{Id: ASC}]) {
    Name
    pruefstand_bestellungen(orderBy: [{Id: ASC}]) { Betrag }
    pruefstand_bestellungen_aggregate { count sum { Betrag } }
} }

Antwort
{"pruefstand_kunden":[{"Name":"Anna","pruefstand_bestellungen":[{"Betrag":"10.00"},{"Betrag":"20.50"}],"pruefstand_bestellungen_aggregate":{"count":2,"sum":{"Betrag":"30.50"}}},{"Name":"Bruno","pruefstand_bestellungen":[{"Betrag":"5.25"}],"pruefstand_bestellungen_aggregate":{"count":1,"sum":{"Betrag":"5.25"}}},{"Name":"Clara","pruefstand_bestellungen":[],"pruefstand_bestellungen_aggregate":{"count":0,"sum":{"Betrag":null}}}]}

Mutationen

mutation {
  neu: insert_pruefstand_kunden(objects: [{Name: "Dora", Ort: "Basel"}]) { affected_rows returning { Name Ort } }
  weg: delete_pruefstand_kunden(where: {Name: {eq: "Dora"}}) { affected_rows }
}

Antwort
{"neu":{"affected_rows":1,"returning":[{"Name":"Dora","Ort":"Basel"}]},"weg":{"affected_rows":1}}