Diagnosztikai üzenetek

A rendszer minden SQLSTATE-vel diagnosztikai üzenetet ad vissza. Ugyanazt az SQLSTATE-t gyakran több különböző üzenettel adja vissza a rendszer. A rendszer például az SQLSTATE 42000 (szintaxishiba vagy hozzáférés-megsértés) függvényt adja vissza a legtöbb sql-szintaxisbeli hiba esetén. Azonban minden szintaxishibát valószínűleg egy másik üzenet ír le.

A minta diagnosztikai üzenetek szerepelnek az A függelék SQLSTATE-ek táblázatának hiba oszlopában és az egyes függvényeknél. Bár az illesztőprogramok vissza tudják adni ezeket az üzeneteket, valószínűbb, hogy az adatforrás bármilyen üzenetet ad vissza nekik.

Az alkalmazások általában diagnosztikai üzeneteket jelenítenek meg a felhasználónak az SQLSTATE és a natív hibakód mellett. Ez segít a felhasználónak és a támogatási személyzetnek meghatározni a problémák okát. Az üzenetbe ágyazott összetevőadatok különösen hasznosak ebben a műveletben.

A diagnosztikai üzenetek egy ODBC-kapcsolat adatforrásaiból és összetevőiből származnak, például illesztőprogramokból, átjárókból és az Illesztőprogram-kezelőből. Az adatforrások általában nem támogatják közvetlenül az ODBC-t. Ezért ha egy ODBC-kapcsolat egyik összetevője üzenetet kap egy adatforrástól, az adatforrást kell azonosítania az üzenet forrásaként. Azt is azonosítania kell magát, mint az üzenet fogadó összetevő.

Ha egy hiba vagy figyelmeztetés forrása maga az összetevő, a diagnosztikai üzenetnek ezt meg kell magyaráznia. Ezért az üzenetek szövegének két különböző formátuma van. Adatforrásban nem előforduló hibák és figyelmeztetések esetén a diagnosztikai üzenetnek ezt a formátumot kell használnia:

[vendor-identifier][ODBC-component-identifier]component-supplied-text

Adatforrásban előforduló hibák és figyelmeztetések esetén a diagnosztikai üzenetnek ezt a formátumot kell használnia:

[vendor-identifier][ODBC-component-identifier][data-source-identifier]data-source-supplied-text

Az alábbi táblázat az egyes elemek jelentését mutatja be.

Elem	Meaning
szállító-azonosító	Azonosítja annak az összetevőnek a szállítóját, amelyben a hiba vagy figyelmeztetés történt, vagy amely közvetlenül az adatforrásból kapta a hibát vagy figyelmeztetést.
ODBC-component-identifier	Azonosítja azt az összetevőt, amelyben a hiba vagy figyelmeztetés történt, vagy amely közvetlenül az adatforrásból kapta a hibát vagy figyelmeztetést.
adatforrás-azonosító	Azonosítja az adatforrást. A fájlalapú illesztőprogramok esetében ez általában egy fájlformátum, például Xbase[1] A DBMS-alapú illesztőprogramok esetében ez a DBMS-termék.
összetevő által megadott szöveg	Az ODBC-összetevő hozza létre.
adatforrás által megadott szöveg	Az adatforrás hozza létre.

[1] Ebben az esetben az illesztőprogram az illesztőprogramként és az adatforrásként is működik.

A zárójeleket ([ ]) fel kell venni az üzenetbe, és nem jelölhetnek választható elemeket.