Tanılama İletileri

Her SQLSTATE ile bir tanılama iletisi döndürülür. Aynı SQLSTATE genellikle bir dizi farklı iletiyle döndürülür. Örneğin, SQLSTATE 42000 (Söz dizimi hatası veya erişim ihlali) SQL söz dizimindeki hataların çoğu için döndürülür. Ancak, her söz dizimi hatasının farklı bir iletiyle açıklanması olasıdır.

Örnek tanılama iletileri, Ek A'daki SQLSTATEs tablosundaki Hata sütununda ve her işlevde listelenir. Sürücüler bu iletileri döndürese de, veri kaynağı tarafından kendilerine iletilen iletileri döndürme olasılığı daha yüksektir.

Uygulamalar genellikle sqlstate ve yerel hata koduyla birlikte kullanıcıya tanılama iletileri görüntüler. Bu, kullanıcı ve destek personelinin sorunların nedenini belirlemesine yardımcı olur. İletiye eklenen bileşen bilgileri bunu yaparken özellikle yararlıdır.

Tanılama iletileri sürücüler, ağ geçitleri ve Sürücü Yöneticisi gibi bir ODBC bağlantısındaki veri kaynaklarından ve bileşenlerinden gelir. Veri kaynakları genellikle ODBC'yi doğrudan desteklemez. Sonuç olarak, ODBC bağlantısındaki bir bileşen veri kaynağından bir ileti alırsa, veri kaynağını iletinin kaynağı olarak tanımlaması gerekir. Ayrıca kendisini iletiyi alan bileşen olarak tanımlaması gerekir.

Hatanın veya uyarının kaynağı bir bileşenin kendisiyse, tanılama iletisi bunu açıklamalıdır. Bu nedenle, ileti metninin iki farklı biçimi vardır. Veri kaynağında oluşmayan hatalar ve uyarılar için tanılama iletisi şu biçimi kullanmalıdır:

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

Bir veri kaynağında oluşan hatalar ve uyarılar için tanılama iletisi şu biçimi kullanmalıdır:

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

Aşağıdaki tabloda her öğenin anlamı gösterilmektedir.

Öğe	Meaning
satıcı tanımlayıcısı	Hatanın veya uyarının oluştuğu veya hatayı ya da uyarıyı doğrudan veri kaynağından alan bileşenin satıcısını tanımlar.
ODBC-bileşen-tanımlayıcısı	Hatanın veya uyarının oluştuğu veya hatayı veya uyarıyı doğrudan veri kaynağından alan bileşeni tanımlar.
veri kaynağı tanımlayıcısı	Veri kaynağını tanımlar. Dosya tabanlı sürücüler için bu genellikle Xbase[1] gibi bir dosya biçimidir. DBMS tabanlı sürücüler için bu, DBMS ürünüdür.
bileşen tarafından sağlanan metin	ODBC bileşeni tarafından oluşturulur.
veri kaynağı tarafından sağlanan metin	Veri kaynağı tarafından oluşturulur.

[1] Bu durumda, sürücü hem sürücü hem de veri kaynağı olarak hareket ediyor.

Köşeli ayraçlar ([ ]) iletiye eklenmelidir ve isteğe bağlı öğeleri göstermez.