Kako gonilnik razvršča in javlja odgovore

graph TD
    A["Odgovor storitve ali prekinitev povezave"] --> B{"Status HTTP"}
    B -->|"2xx"| C{"Ali se oblika ujema z zahtevo?"}
    C -->|"da"| D["Rezultat: vrstice, število ali prizadeti zapisi"]
    C -->|"ne"| X["08S01: odgovor neuporaben"]
    B -->|"401, 403 z izzivom"| H["Vprašaj za kodo ali identiteto, zahtevo enkrat pošlji znova"]
    B -->|"4xx s sporočili podatkovne zbirke"| E["za vsako sporočilo en diagnostični zapis s številko in SQLSTATE"]
    B -->|"drugi 4xx, 5xx, 504"| F["en diagnostični zapis s statusom HTTP kot številko"]
    A -->|"povezava prekinjena"| W["ponovi, kjer je neškodljivo; sicer 08S01"]

Slika: Gonilnik najprej presodi status HTTP, nato obliko, ki je pričakovana za poslano zahtevo. Vsebino in obliko uspeha opisuje Kako iz storitve OData nastane relacijski model ODBC.

Odgovor HTTP sam po sebi ni rezultat v smislu ODBC: lahko vsebuje podatke, zavrnitev storitve, sporočila podatkovne zbirke ali obliko, s katero gonilnik ne zna ničesar narediti. Ta stran za vsak razred odgovorov določa, katero povratno kodo dobi aplikacija, kateri diagnostični zapisi (SQLSTATE, izvorna številka napake, besedilo) nastanejo in v kakšnem stanju sta nato stavek in povezava.

• Uspeh samo pri ustrezni obliki: 200 z neberljivo ali nepričakovano vsebino ni uspeh.
• Sporočila podatkovne zbirke kot prek neposredne povezave: številka, SQLSTATE in besedilo za vsako sporočilo.
• Brez izmišljenih rezultatov: prekinjen odgovor ali odgovor, ki ga je storitev skrajšala, se ne javi kot popoln.

Odgovor, ki ima eno od teh oblik, a vsebuje eno polje več od pričakovanega, velja za ustreznega: neznana polja in anotacije gonilnik preskoči. To ga ohranja združljivega s poznejšimi različicami storitve, ima pa posledico, ki je navedena pod Omejitve.

Zakaj 08S01 za neuporaben odgovor. ODBC ne pozna lastnega SQLSTATE za „nasprotna stran ne odgovarja v skladu s protokolom“. 08S01 („Communication link failure“) aplikaciji pove, kaj storiti: sam stavek ni napačen, napačna je nasprotna stran; ponovitev z istim stavkom lahko uspe, ko storitev spet pravilno odgovarja. Sporočilo ta primer loči od izpada omrežja.

ODBC opozorilo javi kot SQL_SUCCESS_WITH_INFO z diagnostičnim zapisom razreda 01. Ta gonilnik ustvarja samo lastna opozorila:

Obvestila podatkovne zbirke ob uspehu ne dosežejo aplikacije. Če podatkovna zbirka k uspešnemu stavku pošlje sporočilo (v SQL Serverju na primer PRINT ali RAISERROR z resnostjo do 10), dobi aplikacija prek gonilnika SQL Serverja SQL_SUCCESS_WITH_INFO s tem sporočilom. Prek tega gonilnika aplikacija dobi SQL_SUCCESS brez sporočila: podatkovni prehod Wkl.Data.Gateway sporočila posreduje samo ob zavrnitvi, gonilnik pa v uspešnem odgovoru nobenega ne bere. Spremljajoče obvestilo k zavrnitvi (SQLSTATE 01000) pa se pojavi kot nadaljnji diagnostični zapis napake.

Če se povezava prekine brez odgovora, gonilnik zahtevo ponovi po 1 in po 3 sekundah: bralne zahteve vedno, spremembe in lastne stavke, katerih rezultat se prebere v celoti, z istim Idempotency-Key. Ne ponovijo se prekoračena časovna omejitev, zaključek transakcije in pretočni lastni stavek; z RETRY=OFF se ne ponovi nič. Pri kateri storitvi je to varno, je navedeno v Zaveze glede na vrsto storitve.

• "Der Dienst hat das Ergebnis nach N Zeilen gekürzt" – kaj storiti
• "Der Dienst leitet an … um" – kaj storiti
• Kako iz storitve OData nastane relacijski model ODBC
• Kako gonilnik prevaja stavke: sporočila podatkovne zbirke – kako Access, DAO in ADO.NET prikažejo zapise
• Omejitve: odstopanja od ODBC Driver 18
• Vklop sledenja – kako najdete sporočilo za napako