Pemetaan SQLSTATE
Topik ini membahas nilai SQLSTATE untuk ODBC 2.x dan ODBC 3.x. Untuk informasi selengkapnya tentang nilai ODBC 3.x SQLSTATE, lihat Lampiran A: Kode Kesalahan ODBC.
Dalam ODBC 3.x, HYxxx SQLSTATEs dikembalikan alih-alih S1xxx, dan 42Sxx SQLSTATEs dikembalikan alih-alih S00XX. Ini dilakukan untuk menyelaraskan dengan standar Open Group dan ISO. Dalam banyak kasus, pemetaan tidak satu-ke-satu karena standar telah mendefinisikan ulang interpretasi beberapa SQLSTATEs.
Ketika aplikasi ODBC 2.x ditingkatkan ke aplikasi ODBC 3.x , aplikasi harus diubah untuk mengharapkan ODBC 3.x SQLSTATEs alih-alih ODBC 2.x SQLSTATEs. Tabel berikut mencantumkan ODBC 3.x SQLSTATEs tempat setiap ODBC 2.x SQLSTATE dipetakan.
Ketika atribut lingkungan SQL_ATTR_ODBC_VERSION diatur ke SQL_OV_ODBC2, driver memposting ODBC 2.x SQLSTATEs alih-alih ODBC 3.x SQLSTATEs saat SQLGetDiagField atau SQLGetDiagRec dipanggil. Pemetaan tertentu dapat ditentukan dengan mencatat ODBC 2.x SQLSTATE di kolom 1 dari tabel berikut yang sesuai dengan ODBC 3.x SQLSTATE di kolom 2.
| ODBC 2.x SQLSTATE | ODBC 3.x SQLSTATE | Komentar |
|---|---|---|
| 01S03 | 01001 | |
| 01S04 | 01001 | |
| 22003 | HY019 | |
| 22008 | 22007 | |
| 22.005 | 22018 | |
| 24000 | 07005 | |
| 37000 | 42000 | |
| 70100 | HY018 | |
| S0001 | 42S01 | |
| S0002 | 42S02 | |
| S0011 | 42S11 | |
| S0012 | 42S12 | |
| S0021 | 42S21 | |
| S0022 | 42S22 | |
| S0023 | 42S23 | |
| S1000 | HY000 | |
| S1001 | HY001 | |
| S1002 | 07009 | ODBC 2.x SQLSTATE S1002 dipetakan ke ODBC 3.x SQLSTATE 07009 jika fungsi yang mendasarinya adalah SQLBindCol, SQLColAttribute, SQLExtendedFetch, SQLFetch, SQLFetchScroll, atau SQLGetData. |
| S1003 | HY003 | |
| S1004 | HY004 | |
| S1008 | HY008 | |
| S1009 | HY009 | Dikembalikan untuk penggunaan pointer null yang tidak valid. |
| S1009 | HY024 | Dikembalikan untuk nilai atribut yang tidak valid. |
| S1009 | HY092 | Dikembalikan untuk memperbarui atau menghapus data dengan panggilan ke SQLSetPos, atau menambahkan, memperbarui, atau menghapus data dengan panggilan ke SQLBulkOperations, saat konkurensi bersifat baca-saja. |
| S1010 | HY007 HY010 | SQLSTATE S1010 dipetakan ke SQLSTATE HY007 ketika SQLDescribeCol dipanggil sebelum memanggil SQLPrepare, SQLExecDirect, atau fungsi katalog untuk StatementHandle. Jika tidak, SQLSTATE S1010 dipetakan ke SQLSTATE HY010. |
| S1011 | HY011 | |
| S1012 | HY012 | |
| S1090 | HY090 | |
| S1091 | HY091 | |
| S1092 | HY092 | |
| S1093 | 07009 | ODBC 3.x SQLSTATE 07009 dipetakan ke ODBC 2.x SQLSTATE S1093 jika fungsi yang mendasarinya adalah SQLBindParameter atau SQLDescribeParam. |
| S1096 | HY096 | |
| S1097 | HY097 | |
| S1098 | HY098 | |
| S1099 | HY099 | |
| S1100 | HY100 | |
| S1101 | HY101 | |
| S1103 | HY103 | |
| S1104 | HY104 | |
| S1105 | HY105 | |
| S1106 | HY106 | |
| S1107 | HY107 | |
| S1108 | HY108 | |
| S1109 | HY109 | |
| S1110 | HY110 | |
| S1111 | HY111 | |
| S1C00 | HYC00 | |
| S1T00 | HYT00 |
Catatan
ODBC 3.x SQLSTATE 07008 dipetakan ke ODBC 2.x SQLSTATE S1000.