Pesan Diagnostik

Pesan diagnostik dikembalikan dengan setiap SQLSTATE. SQLSTATE yang sama sering dikembalikan dengan sejumlah pesan yang berbeda. Misalnya, SQLSTATE 42000 (Kesalahan sintaks atau pelanggaran akses) dikembalikan untuk sebagian besar kesalahan dalam sintaks SQL. Namun, setiap kesalahan sintaks kemungkinan akan dijelaskan oleh pesan yang berbeda.

Contoh pesan diagnostik tercantum di kolom Kesalahan dalam tabel SQLSTATEs di Lampiran A dan di setiap fungsi. Meskipun driver dapat mengembalikan pesan ini, mereka lebih cenderung mengembalikan pesan apa pun yang diteruskan kepada mereka oleh sumber data.

Aplikasi umumnya menampilkan pesan diagnostik kepada pengguna, bersama dengan SQLSTATE dan kode kesalahan asli. Ini membantu pengguna dan personel dukungan menentukan penyebab masalah apa pun. Informasi komponen yang disematkan dalam pesan sangat membantu dalam melakukan ini.

Pesan diagnostik berasal dari sumber data dan komponen dalam koneksi ODBC, seperti driver, gateway, dan Driver Manager. Biasanya, sumber data tidak secara langsung mendukung ODBC. Akibatnya, jika komponen dalam koneksi ODBC menerima pesan dari sumber data, komponen tersebut harus mengidentifikasi sumber data sebagai sumber pesan. Ini juga harus mengidentifikasi dirinya sebagai komponen yang menerima pesan.

Jika sumber kesalahan atau peringatan adalah komponen itu sendiri, pesan diagnostik harus menjelaskan hal ini. Oleh karena itu, teks pesan memiliki dua format yang berbeda. Untuk kesalahan dan peringatan yang tidak terjadi di sumber data, pesan diagnostik harus menggunakan format ini:

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

Untuk kesalahan dan peringatan yang terjadi di sumber data, pesan diagnostik harus menggunakan format ini:

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

Tabel berikut menunjukkan arti setiap elemen.

Elemen	Makna
pengidentifikasi vendor	Mengidentifikasi vendor komponen tempat kesalahan atau peringatan terjadi atau yang menerima kesalahan atau peringatan langsung dari sumber data.
Pengidentifikasi komponen ODBC	Mengidentifikasi komponen tempat kesalahan atau peringatan terjadi atau yang menerima kesalahan atau peringatan langsung dari sumber data.
pengidentifikasi sumber data	Mengidentifikasi sumber data. Untuk driver berbasis file, ini biasanya merupakan format file, seperti Xbase[1] Untuk driver berbasis DBMS, ini adalah produk DBMS.
teks yang disediakan komponen	Dihasilkan oleh komponen ODBC.
data-source-supplied-text	Dihasilkan oleh sumber data.

[1] Dalam hal ini, driver bertindak sebagai driver dan sumber data.

Tanda kurung siku ([ ]) harus disertakan dalam pesan dan tidak menunjukkan item opsional.