SQLSTATE 對應
本主題討論 ODBC 2.x 和 ODBC 3.x的 SQLSTATE 值。 如需 ODBC 3.x SQLSTATE 值的詳細資訊，請參閱附錄 A：ODBC 錯誤碼。
在 ODBC 3.x 中，系統會傳回 HYxxx SQLSTATE 而非 S1xxx，而且會傳回 42Sxx SQLSTATE 而非 S00XX。 這是為了與 Open Group 和 ISO 標準保持一致。 在許多情況下，由於數個 SQLSTATE 解譯的標準重新定義，因此對應不是一對一的。
當 ODBC 2.x 應用程式升級為 ODBC 3.x 應用程式時，必須變更應用程式以預期使用 ODBC 3.x SQLSTATE，而非 ODBC 2.x SQLSTATE。 下表列出每個 ODBC 2.x SQLSTATE 所對應的 ODBC 3.x SQLSTATE。
當 SQL_ATTR_ODBC_VERSION 環境屬性設為 SQL_OV_ODBC2 時，驅動程式會在呼叫 SQLGetDiagField 或 SQLGetDiagRec 時貼上 ODBC 2.x SQLSTATE，而非 ODBC 3.x SQLSTATE。 您可以注意下表第 1 欄中的 ODBC 2.x SQLSTATE 和其對應的第 2 欄 ODBC 3.x SQLSTATE 以確認特定的對應。
| ODBC 2.x SQLSTATE | ODBC 3.x SQLSTATE | 註解 |
|---|---|---|
| 01S03 | 01001 | |
| 01S04 | 01001 | |
| 22003 | HY019 | |
| 22008 | 22007 | |
| 22005 | 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 | 如果基礎函式是 SQLBindCol、SQLColAttribute、SQLExtendedFetch、SQLFetch、SQLFetchScroll 或 SQLGetData，則 ODBC 2.x SQLSTATE S1002 會對應至 ODBC 3.x SQLSTATE 07009。 |
| S1003 | HY003 | |
| S1004 | HY004 | |
| S1008 | HY008 | |
| S1009 | HY009 | Null 指標用法不正確時傳回。 |
| S1009 | HY024 | 屬性值不正確時傳回。 |
| S1009 | HY092 | 在並行為唯讀時，呼叫 SQLSetPos 以更新或刪除資料，或呼叫 SQLBulkOperations 以新增、更新或刪除資料時，傳回此數值。 |
| S1010 | HY007 HY010 | 在呼叫 SQLPrepare、SQLExecDirect 或 StatementHandle 的目錄函式之前呼叫 SQLDescribeCol 時，SQLSTATE S1010 會對應到 SQLSTATE HY007。 否則，SQLSTATE S1010 會對應至 SQLSTATE HY010。 |
| S1011 | HY011 | |
| S1012 | HY012 | |
| S1090 | HY090 | |
| S1091 | HY091 | |
| S1092 | HY092 | |
| S1093 | 07009 | 如果基礎函式是 SQLBindParameter 或 SQLDescribeParam，ODBC 3.x SQLSTATE 07009 對應至 ODBC 2.x SQLSTATE S1093。 |
| 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 |
注意
ODBC 3.x SQLSTATE 07008 會對應至 ODBC 2.x SQLSTATE S1000。