附錄 A：ODBC 錯誤碼
本主題討論 ODBC 3 的 SQLSTATE 值。 x . 如需 ODBC 3 的詳細資訊。 x SQLSTATE 值，請參閱 SQLSTATE 對應 。
SQLGetDiagRec 或 SQLGetDiagField 會傳回 SQLSTATE 值，如 Open Group Data Management：結構化查詢語言（SQL），第 2 版（1995 年 3 月）。 SQLSTATE 值是包含五個字元的字串。 下表列出驅動程式可以針對 SQLGetDiagRec 傳回的 SQLSTATE 值。
針對 SQLSTATE 傳回的字元字串值是由兩個字元類別值所組成，後面接著三個字元的子類別值。 「01」 的類別值表示警告，並隨附SQL_SUCCESS_WITH_INFO的傳回碼。 「01」 以外的類別值，除了類別 「IM」之外，表示錯誤，並伴隨傳回值SQL_ERROR。 類別 「IM」 專屬於衍生自 ODBC 本身實作的警告和錯誤。 任何類別中的子類別值 「000」 表示該 SQLSTATE 沒有子類別。 類別和子類別值的指派是由 SQL-92 所定義。
注意
雖然函式的成功執行通常以傳回值SQL_SUCCESS表示，但 SQLSTATE 00000 也表示成功。
| SQLSTATE | 錯誤 | 可以從 |
|---|---|---|
| 01000 | 一般警告 | 除了下列所有 ODBC 函式： SQLError SQLGetDiagField SQLGetDiagRec |
| 01001 | 資料指標作業衝突 | SQLExecDirect SQLExecute SQLParamData SQLSetPos |
| 01002 | 中斷連線錯誤 | SQLDisconnect |
| 01003 | set 函式中排除的 Null 值 | SQLExecDirect SQLExecute SQLParamData |
| 01004 | 字串資料，右截斷 | SQLBrowseConnect SQLBulkOperations SQLColAttribute SQLDataSources SQLDescribeCol SQLDriverConnect SQLDrivers SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLGetConnectAttr SQLGetCursorName SQLGetData SQLGetDescField SQLGetDescRec SQLGetEnvAttr SQLGetInfo SQLGetStmtAttr SQLNative Sql SQLParamData SQLPutData SQLSetCursorName |
| 01006 | 許可權未撤銷 | SQLExecDirect SQLExecute SQLParamData |
| 01007 | 未授與許可權 | SQLExecDirect SQLExecute SQLParamData |
| 01S00 | 不正確連接字串屬性 | SQLBrowseConnect SQLDriverConnec |
| 01S01 | 資料列中的錯誤 | SQLBulkOperations SQLExtendedFetch SQLSetPos |
| 01S02 | 選項值已變更 | SQLBrowseConnect SQLConnect SQLDriverConnect SQLExecDirect SQLExecute SQLParamData SQLPrepare SQLSetConnectAttr SQLSetDescField SQLSetEnvAttr SQLSetStmtAttr |
| 01S06 | 嘗試在結果集傳回第一個資料列集之前擷取 | SQLExtendedFetch SQLFetchScroll |
| 01S07 | 小數截斷 | SQLBulkOperations SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLGetData SQLParamData SQLSetPos |
| 01S08 | 儲存檔案 DSN 時發生錯誤 | SQLDriverConnect |
| 01S09 | 不正確關鍵字 | SQLDriverConnect |
| 07001 | 參數數目錯誤 | SQLExecDirect SQLExecute |
| 07002 | COUNT 欄位不正確 | SQLExecDirect SQLExecute SQLParamData |
| 07005 | 備妥語句不是資料 指標規格 | SQLColAttribute SQLDescribeCol |
| 07006 | 受限制的資料類型屬性違規 | SQLBindCol SQLBindParameter SQLBulkOperations SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLGetData SQLParamData SQLPutData SQLSetPos |
| 07009 | 不正確描述元索引 | SQLBindCol SQLBindParameter SQLBulkOperations SQLColAttribute SQLDescribeCol SQLDescribeParam SQLFetch SQLFetchScroll SQLGetData SQLGetDescField SQLGetDescRec SQLParamData SQLSetDescField SQLSetDescRecSQLSetPos |
| 07S01 | 預設參數的使用無效 | SQLExecDirect SQLExecute SQLParamData SQLPutData |
| 08001 | 用戶端無法建立連線 | SQLBrowseConnect SQLConnect SQLDriverConnect |
| 08002 | 使用中的連線名稱 | SQLBrowseConnect SQLConnect SQLDriverConnect SQLSetConnectAttr |
| 08003 | 連線未開啟 | SQLAllocHandle SQLDisconnect SQLEndTran SQLGetConnectAttr SQLGetInfo SQLNativeSql SQLSetConnectAttr |
| 08004 | 伺服器拒絕連線 | SQLBrowseConnect SQLConnect SQLDriverConnect |
| 08007 | 交易期間的連線失敗 | SQLEndTran |
| 08S01 | 通訊連結失敗 | SQLBrowseConnect SQLColumnPrivileges SQLColumns SQLConnect SQLCopyDesc SQLDescribeCol SQLDescribeParam SQLDriverConnect SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLForeignKeys SQLGetConnectAttr SQLGetData SQLGetDescField SQLGetDescRec SQLGetFunctions SQLGetInfo SQLGetTypeInfo SQLMoreResults SQLNativeSql SQLNumParams SQLNumResultCols SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLPutData SQLSetConnectAttr SQLSetDescField SQLSetDescRec SQLSetEnvAttr SQLSetStmtAttr SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| 21S01 | 插入值清單不符合資料行清單 | SQLExecDirect SQLPrepare |
| 21S02 | 衍生資料表的程度不符合資料行清單 | SQLBulkOperations SQLExecDirect SQLExecute SQLParamData SQLPrepare SQLSetPos |
| 22001 | 字串資料，右截斷 | SQLBulkOperations SQLExecDirect SQLExecute SQLFetch SQLFetchScroll SQLParamData SQLPutData SQLSetDescField SQLSetPos |
| 22002 | 需要指標變數，但未提供 | SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLGetData SQLParamData |
| 22003 | 超出範圍的數值 | SQLBulkOperations SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLGetData SQLGetInfo SQLParamData SQLPutData SQLSetPos |
| 22007 | 不正確日期時間格式 | SQLBulkOperations SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLGetData SQLParamData SQLPutData SQLSetPos |
| 22008 | 日期時間欄位溢位 | SQLBulkOperations SQLExecDirect QLParamData SQLPutData |
| 22012 | 除以零 | SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLGetData SQLPutData |
| 22015 | 間隔欄位溢位 | SQLBulkOperations SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLGetData SQLParamData SQLPutData SQLSetPos |
| 22018 | 轉換規格的字元值無效 | SQLBulkOperations SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLGetData SQLParamData SQLPutData SQLSetPos |
| 22019 | 不正確逸出字元 | SQLExecDirect SQLExecute SQLPrepare |
| 22025 | 不正確逸出序列 | SQLExecDirect SQLExecute SQLPrepare |
| 22026 | 字串資料，長度不符 | SQLParamData |
| 23000 | 完整性條件約束違規 | SQLBulkOperations SQLExecDirect SQLExecute SQLParamData SQLSetPos |
| 24000 | 不正確資料指標狀態 | SQLBulkOperations SQLCloseCursor SQLColumnPrivileges SQLColumns SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLForeignKeys SQLGetData SQLGetStmtAttr SQLGetTypeInfo SQLNativeSql SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLSetConnectAttr SQLSetCursorName SQLSetPos SQLSetStmtAttr SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| 25000 | 不正確交易狀態 | SQLDisconnect |
| 25S01 | 交易狀態 | SQLEndTran |
| 25S02 | 交易仍在使用中 | SQLEndTran |
| 25S03 | 交易已回復 | SQLEndTran |
| 28000 | 授權規格無效 | SQLBrowseConnect SQLConnect SQLDriverConnect |
| 34000 | 不正確資料指標名稱 | SQLExecDirect SQLPrepare SQLSetCursorName |
| 3C000 | 重複的資料指標名稱 | SQLSetCursorName |
| 3D000 | 不正確目錄名稱 | SQLExecDirect SQLPrepare SQLSetConnectAttr |
| 3F000 | 不正確架構名稱 | SQLExecDirect SQLPrepare |
| 40001 | 序列化失敗 | SQLBulkOperations SQLColumnPrivileges SQLColumns SQLEndTran SQLExecDirect SQLExecute SQLFetch SQLFetchScroll SQLForeignKeys SQLGetTypeInfo SQLMoreResults SQLParamData SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLSetPos SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| 40002 | 完整性條件約束違規 | SQLEndTran |
| 40003 | 語句完成未知 | SQLBulkOperations SQLColumnPrivileges SQLColumns SQLExecDirect SQLExecute SQLFetch SQLFetchScroll SQLForeignKeys SQLGetTypeInfo SQLMoreResults SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLParamData SQLSetPos SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| 42000 | 語法錯誤或存取違規 | SQLBulkOperations SQLExecDirect SQLExecute SQLParamData SQLPrepare SQLSetPos |
| 42S01 | 基表或檢視已經存在 | SQLExecDirect SQLPrepare |
| 42S02 | 找不到基表或檢視表 | SQLExecDirect SQLPrepare |
| 42S11 | 索引已經存在 | SQLExecDirect SQLPrepare |
| 42S12 | 找不到索引 | SQLExecDirect SQLPrepare |
| 42S21 | 資料行已經存在 | SQLExecDirect SQLPrepare |
| 42S22 | 找不到資料行 | SQLExecDirect SQLPrepare |
| 44000 | WITH CHECK OPTION 違規 | SQLBulkOperations SQLExecDirect SQLExecute SQLParamData SQLSetPos |
| HY000 | 一般錯誤 | 除了下列所有 ODBC 函式： SQLError SQLGetDiagField SQLGetDiagRec |
| HY001 | 記憶體配置錯誤 | 除了下列所有 ODBC 函式： SQLError SQLGetDiagField SQLGetDiagRec |
| HY003 | 不正確應用程式緩衝區類型 | SQLBindCol SQLBindParameter SQLGetData |
| HY004 | 不正確 SQL 資料類型 | SQLBindParameter SQLGetTypeInfo |
| HY007 | 未備妥相關聯的語句 | SQLCopyDesc SQLGetDescField SQLGetDescRec |
| HY008 | 作業已取消 | 可以非同步處理的所有 ODBC 函式： SQLBrowseConnect SQLBulkOperations SQLColAttribute SQLColumnPrivileges SQLColumns SQLConnect SQLDescribeCol SQLDescribeParam SQLDisconnect SQLDriverConnect SQLEndTran SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLForeignKeys SQLGetData SQLGetTypeInfo SQLMoreResults SQLNumParams SQLNumResultCols SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLPutData SQLSetConnectAttr SQLSetPos SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HY009 | 不正確 Null 指標使用 | SQLAllocHandle SQLBindParameter SQLBulkOperations SQLColumnPrivileges SQLColumns SQLExecDirect SQLForeignKeys SQLGetCursorName SQLGetData SQLGetFunctions SQLNativeSql SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLPutData SQLSetConnectAttr SQLSetCursorName SQLSetEnvAttr SQLSetStmtAttr SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HY010 | 函式順序錯誤 | SQLAllocHandle SQLBindCol SQLBindParameter SQLBulkOperations SQLCloseCursor SQLColAttribute SQLColumnPrivileges SQLColumns SQLCopyDesc SQLDescribeCol SQLDescribeParam SQLDisconnect SQLEndTran SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLForeignKeys SQLFreeHandle SQLFreeStmt SQLGetConnectAttr SQLGetCursorName SQLGetData SQLGetDescField SQLGetDescRec SQLGetFunctions SQLGetStmtAttr SQLGetTypeInfo SQLMoreResults SQLNumParams SQLNumResultCols SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLPutData SQLRowCount SQLSetConnectAttr SQLSetCursorName SQLSetDescField SQLSetEnvAttr SQLSetDescRec SQLSetPos SQLSetStmtAttr SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HY011 | 無法立即設定屬性 | SQLBulkOperations SQLParamData QLSetPos SQLSetStmtAttr |
| HY012 | 不正確交易作業程式碼 | SQLEndTran |
| HY013 | 記憶體管理錯誤 | 除了下列所有 ODBC 函式： SQLGetDiagField SQLGetDiagRec |
| HY014 | 超過控制碼數目的限制 | SQLAllocHandle |
| HY015 | 沒有可用的資料指標名稱 | SQLGetCursorName |
| HY016 | 無法修改實作資料列描述元 | SQLCopyDesc SQLSetDescField SQLSetDescRec |
| HY017 | 自動設定描述元控制碼的使用無效 | SQLFreeHandle SQLSetStmtAttr |
| HY018 | 伺服器拒絕取消要求 | SQLCancel |
| HY019 | 以片段傳送的非字元和非二進位資料 | SQLPutData |
| HY020 | 嘗試串連 Null 值 | SQLPutData |
| HY021 | 不一致的描述元資訊 | SQLBindParameter SQLCopyDesc SQLGetDescField SQLSetDescField SQLSetDescRec |
| HY024 | 不正確屬性值 | SQLSetConnectAttr SQLSetEnvAttr SQLSetStmtAttr |
| HY090 | 不正確字串或緩衝區長度 | SQLBindCol SQLBindParameter SQLBrowseConnect SQLBulkOperations SQLColAttribute SQLColumnPrivileges SQLColumns SQLConnect SQLDataSources SQLDescribeCol SQLDriverConnect SQLDrivers SQLExecDirect SQLExecute SQLFetch SQLFetchScroll SQLForeignKeys SQLGetConnectAttr SQLGetCursorName SQLGetData SQLGetDescField SQLGetInfo SQLGetStmtAttr SQLNativeSql SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLPutData SQLSetConnectAttr SQLSetCursorName SQLSetDescField SQLSetDescRec SQLSetEnvAttr SQLSetStmtAttr SQLSetPos SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HY091 | 不正確描述元欄位識別碼 | SQLColAttribute SQLGetDescField SQLSetDescField |
| HY092 | 不正確屬性/選項識別碼 | SQLAllocHandle QLBulkOperations SQLCopyDesc SQLDriverConnect SQLEndTran SQLFreeStmt SQLGetConnectAttr SQLGetEnvAttr QLParamData SQLSetConnectAttr SQLSetDescField SQLSetEnvAttr SQLSetPos SQLSetStmtAttr |
| HY095 | 超出範圍的函式類型 | SQLGetFunctions |
| HY096 | 不正確資訊類型 | SQLGetInfo |
| HY097 | 超出範圍的資料行類型 | SQLSpecialColumns |
| HY098 | 範圍類型超出範圍 | SQLSpecialColumns |
| HY099 | 可為 Null 的類型超出範圍 | SQLSpecialColumns |
| HY100 | 超出範圍的唯一性選項類型 | SQLStatistics |
| HY101 | 精確度選項類型超出範圍 | SQLStatistics |
| HY103 | 不正確擷取程式 | SQLDataSources SQLDrivers |
| HY104 | 不正確有效位數或小數位數值 | SQLBindParameter |
| HY105 | 不正確參數類型 | SQLBindParameter SQLExecDirect SQLExecute SQLParamData SQLSetDescField |
| HY106 | 擷取超出範圍的類型 | SQLExtendedFetch SQLFetchScroll |
| HY107 | 超出範圍的資料列值 | SQLExtendedFetch SQLFetch SQLFetchScroll SQLSetPos |
| HY109 | 不正確資料指標位置 | SQLExecDirect SQLExecute SQLGetData SQLGetStmtAttr SQLNativeSql SQLParamData SQLSetPos |
| HY110 | 不正確驅動程式完成 | SQLDriverConnect |
| HY111 | 不正確書簽值 | SQLExtendedFetch SQLFetchScroll |
| HYC00 | 未實作選擇性功能 | SQLBindCol SQLBindParameter SQLBulkOperations SQLColAttribute SQLColumnPrivileges SQLColumns SQLDriverConnect SQLEndTran SQLExecDirect SQLExecute SQLExtendedFetch SQLFetch SQLFetchScroll SQLForeignKeys SQLGetConnectAttr SQLGetData SQLGetEnvAttr SQLGetInfo SQLGetStmtAttr SQLGetTypeInfo SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLSetConnectAttr SQLSetEnvAttr SQLSetPos SQLSetStmtAttr SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HYT00 | 逾時已超過 | SQLBrowseConnect SQLBulkOperations SQLColumnPrivileges SQLColumns SQLConnect SQLDriverConnect SQLExecDirect SQLExecute SQLExtendedFetch SQLForeignKeys SQLGetTypeInfo SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLSetPos SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HYT01 | 已超過連線逾時 | 除了下列所有 ODBC 函式： SQLDrivers SQLDataSources SQLGetEnvAttr SQLSetEnvAttr |
| IM001 | 驅動程式不支援此函式 | 除了下列所有 ODBC 函式： SQLAllocHandle SQLDataSources SQLDrivers SQLFreeHandle SQLGetFunctions |
| IM002 | 找不到資料來源名稱，也沒有指定預設驅動程式 | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM003 | 無法載入指定的驅動程式 | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM004 | SQL_HANDLE_ENV上的驅動程式 SQLAllocHandle 失敗 | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM005 | SQL_HANDLE_DBC上的驅動程式 SQLAllocHandle 失敗 | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM006 | 驅動程式的 SQLSetConnectAttr 失敗 | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM007 | 未指定資料來源或驅動程式;對話方塊禁止 | SQLDriverConnect |
| IM008 | 對話方塊失敗 | SQLDriverConnect |
| IM009 | 無法載入翻譯 DLL | SQLBrowseConnect SQLConnect SQLDriverConnect SQLSetConnectAttr |
| IM010 | 資料來源名稱太長 | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM011 | 驅動程式名稱太長 | SQLBrowseConnect SQLDriverConnect |
| IM012 | DRIVER 關鍵字語法錯誤 | SQLBrowseConnect SQLDriverConnect |
| IM013 | 追蹤檔案錯誤 | 所有 ODBC 函式。 |
| IM014 | 不正確檔案 DSN 名稱 | SQLDriverConnect |
| IM015 | 損毀的檔案資料來源 | SQLDriverConnect |