Wie der Treiber Antworten einordnet und meldet

graph TD
    A["Antwort des Dienstes oder Abbruch der Verbindung"] --> B{"HTTP-Status"}
    B -->|"2xx"| C{"Form passt zur Anfrage?"}
    C -->|"ja"| D["Ergebnis: Zeilen, Anzahl oder betroffene Sätze"]
    C -->|"nein"| X["08S01: Antwort unbrauchbar"]
    B -->|"401, 403 mit Herausforderung"| H["Code oder Identität erfragen, Anfrage einmal neu senden"]
    B -->|"4xx mit Meldungen der Datenbank"| E["je Meldung ein Diagnosesatz mit Nummer und SQLSTATE"]
    B -->|"übrige 4xx, 5xx, 504"| F["ein Diagnosesatz mit dem HTTP-Status als Nummer"]
    A -->|"Verbindung abgebrochen"| W["wiederholen, wo unschädlich; sonst 08S01"]

Abbildung: Der Treiber entscheidet zuerst nach dem HTTP-Status, danach nach der Form, die für die gestellte Anfrage zu erwarten ist. Inhalt und Form eines Erfolgs beschreibt Wie aus einem OData-Dienst ein relationales ODBC-Modell wird.

Eine HTTP-Antwort ist nicht von selbst ein Ergebnis im Sinne von ODBC: Sie kann Daten tragen, eine Ablehnung des Dienstes, Meldungen der Datenbank oder eine Form, mit der der Treiber nichts anfangen kann. Diese Seite legt für jede Klasse von Antworten fest, welchen Rückgabewert die Anwendung erhält, welche Diagnosesätze (SQLSTATE, native Fehlernummer, Text) entstehen und in welchem Zustand Anweisung und Verbindung danach sind.

• Erfolg nur bei passender Form: Ein 200 mit unlesbarem oder unerwartetem Inhalt ist kein Erfolg.
• Meldungen der Datenbank wie über eine direkte Verbindung: Nummer, SQLSTATE und Text je Meldung.
• Keine erfundenen Ergebnisse: Eine abgebrochene oder vom Dienst gekürzte Antwort wird nicht als vollständig gemeldet.

Eine Antwort, die eine dieser Formen hat, aber ein Feld mehr trägt als erwartet, gilt als passend: Unbekannte Felder und Annotationen übergeht der Treiber. Das hält ihn mit späteren Versionen eines Dienstes verträglich, hat aber eine Folge, die unter Grenzen steht.

Warum 08S01 für eine unbrauchbare Antwort. ODBC kennt keinen eigenen SQLSTATE für „Gegenstelle antwortet nicht protokollgerecht“. 08S01 („Communication link failure“) sagt der Anwendung, was zu tun ist: Die Anweisung selbst ist nicht falsch, das Gegenüber ist es; eine Wiederholung mit derselben Anweisung kann gelingen, wenn der Dienst wieder richtig antwortet. Die Meldung unterscheidet den Fall von einem Netzausfall.

ODBC meldet eine Warnung als SQL_SUCCESS_WITH_INFO mit einem Diagnosesatz der Klasse 01. Dieser Treiber erzeugt Warnungen nur selbst:

Hinweise der Datenbank bei einem Erfolg erreichen die Anwendung nicht. Sendet die Datenbank zu einer erfolgreichen Anweisung eine Meldung (in SQL Server etwa PRINT oder RAISERROR mit Schwere bis 10), erhält die Anwendung über den Treiber von SQL Server SQL_SUCCESS_WITH_INFO mit dieser Meldung. Über diesen Treiber kommt SQL_SUCCESS ohne sie: Der Datendienst Wkl.Data.Gateway gibt Meldungen nur mit einer Ablehnung weiter, und der Treiber liest in einer erfolgreichen Antwort keine. Ein begleitender Hinweis zu einer Ablehnung (SQLSTATE 01000) erscheint dagegen als weiterer Diagnosesatz des Fehlers.

Bricht die Verbindung ohne Antwort ab, wiederholt der Treiber nach 1 und nach 3 Sekunden: Lesen immer, Änderungen und gesammelt gelesene eigene Anweisungen mit demselben Idempotency-Key. Nicht wiederholt werden eine überschrittene Zeitgrenze, der Abschluss einer Transaktion und eine gestreamte eigene Anweisung; mit RETRY=OFF gar nichts. Wann das für welchen Dienst sicher ist, steht unter Zusagen je Art des Dienstes.

Der Text eines Diagnosesatzes folgt der Anzeigesprache des Windows-Benutzers, unter dem die Anwendung läuft: Deutsch, Slowenisch, sonst Englisch; ebenso die Dialoge des Treibers. Maßgeblich ist Windows, nicht eine Sprache, die eine Anwendung wie Office für sich einstellt. SQLSTATE und native Fehlernummer sind in jeder Sprache dieselben – eine Anwendung, die Fehler auswertet, prüft diese und nicht den Text. Meldungen des Dienstes und der Datenbank gibt der Treiber unverändert weiter, in der Sprache, in der sie dort entstehen. Die eigenen Zeilen der Ablaufverfolgung bleiben deutsch; ein Diagnosesatz steht dort (DIAG) so, wie ihn die Anwendung erhielt. Eine Anwendung, die Meldungen schmal liest (SQLGetDiagRecA), erhält sie in ihrer ANSI-Codepage; slowenische Buchstaben (č, š, ž) enthält nur die Codepage 1250 (Mitteleuropäisch), die ANSI-Codepage eines slowenischen Windows.

• „Der Dienst hat das Ergebnis nach N Zeilen gekürzt“ – was zu tun ist
• „Der Dienst leitet an … um“ – was zu tun ist
• Wie aus einem OData-Dienst ein relationales ODBC-Modell wird
• Wie der Treiber Anweisungen übersetzt: Meldungen der Datenbank – wie Access, DAO und ADO.NET die Sätze zeigen
• Grenzen: Abweichungen von ODBC Driver 18
• So schalten Sie die Ablaufverfolgung ein – die Meldung hinter einem Fehler finden