附录 A：ODBC 错误代码
本主题讨论 ODBC 3 的 SQLSTATE 值。x. 有关 ODBC 3 的详细信息。x SQLSTATE 值，请参阅 SQLSTATE 映射。
SQLGetDiagRec 或 SQLGetDiagField 返回开放组数据管理定义的 SQLSTATE 值：结构化查询语言 (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 |