ZeroBox Notes

根据 X/Open 和 SQL Access Group SQL CAE 规范 (1992) 所进行的定义，SQLERROR 返回 SQLSTATE 值。SQLSTATE 值是包含五个字符的字符串。下表列出了驱动程序可以为 SQLError 返回的 SQLSTATE 值。
为 SQLSTATE 返回的字符串值由两个字符的类值后接三个字符的子类值组成。类值 01 表明是一种警告，后跟随 SQL_SUCCESS_WITH_INFO 的返回代码。只要类值不是 01（IM 除外），则表明是一种错误，后跟随 SQL_ERROR 的返回代码。类 IM 专门用于表明从 ODBC 实现产生的警告和错误。任何类中子类值 000 均用于实现给定类中所定义条件。这种类值和子类值的分配方法由 SQL-92 定义。

说明   通常由返回值 SQL_SUCCESS 表明成功执行了一个函数，但 SQLSTATE 00000 也表明成功执行。
SQLSTATE ODBC API（驱动程序管理器）错误
00000 成功
01000 常规警告
01002 断开连接错误
01004 数据被截断
01006 未废除特权
01S00 无效连接字符串特性
01S01 行中的错误
01S02 选项值已更改
01S03 未更新或删除任何行
01S04 更新或删除了多行
01S05 取消操作被当成 FreeStmt/Close
01S06 设法在结果返回第一个行集之前进行提取
07001 参数个数错误
07006 违反受限制的数据类型特性
07S01 默认参数使用无效
08001 无法连接到数据源
08002 连接正在使用
08003 连接未打开
08004 数据源拒绝建立连接
08007 在执行事务的过程中连接失败
08S01 通讯链接失败
21S01 插入值列表与列列表不匹配
21S02 派生表的程度与列列表不匹配
22001 字符串数据右截断
22002 需要指示符变量，但未提供
22003 数字值超出范围
22005 分配时出错
22008 Datetime 字段溢出
22012 被零除错误
22026 字符串数据，长度不匹配
23000 违反完整性约束
24000* 无效的游标状态
25000 无效的事务状态
28000 无效的授权规范
34000 无效的游标名称
37000 语法错误或违规访问
3C000 重复的游标名称
40001 串行错误
42000 语法错误或违规访问
70100 操作终止
IM001 驱动程序不支持本函数
IM002 未找到源名称并且未指定默认驱动程序
IM003 无法装载指定的驱动程序
IM004 驱动程序的 SQLAllocEnv 失败
IM005 驱动程序的 SQLAllocConnect 失败
IM006 驱动程序的 SQLSetConnectOption 失败
IM007 未指定数据源或驱动程序；禁止对话
IM008 对话失败
IM009 无法装载转换 DLL
IM010 数据源名称过长
IM011 驱动程序名称过长
IM012 DRIVER 关键字语法错误
IM013 跟踪文件错误
S0001 基表或视图已存在
S0002 未找到基表
S0011 索引已经存在
S0012 未找到索引
S0021 列已存在
S0022 未找到列
S0023 列无默认值
S1000 常规错误
S1001 内存分配失败
S1002 列编号无效
S1003 程序类型超出范围
S1004 SQL 数据类型超出范围
S1008 已取消操作
S1009 参数值无效
S1010 函数序列错误
S1011 操作在此时无效
S1012 所指定的事务操作代码无效
S1015 无可用的游标名称
S1090 字符串或缓冲区长度无效
S1091 描述符类型超出范围
S1092 选项类型超出范围
S1093 参数编号无效
S1094 小数位数值无效
S1095 函数类型超出范围
S1096 信息类型超出范围
S1097 列类型超出范围
S1098 作用域类型超出范围
S1099 可为空类型超出范围
S1100 唯一性选项类型超出范围
S1101 准确性选项类型超出范围
S1103 方向选项超出范围
S1104 精度值无效
S1105 参数类型无效
S1106 提取类型超出范围
S1107 行值超出范围
S1108 并发选项超出范围
S1109 游标位置无效
S1110 驱动程序完成无效
S1111 书签值无效
S1C00 驱动程序无法执行
S1DE0 执行值挂起时无数据
S1T00 超时失效
* 在 SQL Server 企业管理器中，当设法保存选定表或保存数据库关系图时，如果 Microsoft® SQL Server™ 用尽资源，则可能接收到”游标状态无效”的错误信息。返回此错误的原因是，数据库或事务日志的空间不足，无法完成保存进程。若要修正此问题，请检查数据库或事务日志是否已满。如果已满，请增加数据库的大小以容纳更改。请检查其它的系统资源或与系统管理员联系。

除 ODBC 程序员参考文档中的标准 ODBC 错误信息外，SQL Server ODBC 驱动程序可以为某些 SQLSTATE 值返回错误信息，如下表所示。
SQLSTATE SQL SERVER 驱动程序错误
描述
01000 已将 %ld 行发送到 SQL Server。共有：%ld 行。 使用 BCP API，已将一批行发送到 SQL Server。
01000 成功进行了大容量复制，已总共将 %ld 行复制到主文件中。共收到：%ld 行。 使用 BCP API，已将一批行写入到主文件中。
01000 已拒绝对在 DSN 中配置的数据库进行访问。使用默认值。 数据库不存在，或用户不具有对该数据库的访问权限。使用了为登录 ID 配置的默认数据库。
01000 在设法访问日志文件时出错，禁用日志记录。 无法使用驱动程序统计或长时间查询的日志文件。已禁用驱动程序统计或长时间查询的日志记录。
01000 连接到备份服务器。 SQL Server 主服务器不可用，因此连接到后备服务器。
01000 不支持在 DSN 中配置的语言。使用默认值。 语言名称无效，或未在服务器上安装该语言。使用了为登录 ID 配置的默认语言。
01000 Null 位数据强制为零。 正将包含 NULL 的位字段装载到不支持 NULL 位数据的服务器。该字段设置为零。
01000 用 ‘EXEC’ 执行了过程。未返回任何输出参数。 无法作为 RPC 执行过程，并且指定了输出参数。因为已用 EXEC 执行了过程，将不存储任何输出参数。
01000 禁用 SQL 调试。 无法启用 SQL 调试，原因是没有为 SQL 调试对 SQL Server 进行配置。
01000 安装在 %s 服务器上的 ODBC 目录存储过程的版本为 %s；要确保正确操作，需要 %02d.%02d.%4.4d 版或更高版本。请与系统管理员联系。 通过执行 \Msqql\Install\Instcat.sql 安装 ODBC 目录存储过程。
01000 将长度为零的数据强制为长度为 1。 正在装载零长度二进制或字符字段，但不支持零长度数据。字段强制为 1 字节空格或二进制零。
01S02 游标并发已更改。 因为请求或查询的类型，应用程序请求了无法遵守的并发。代之以使用另一个并发。
01S02 游标类型已更改。 因为请求或查询的类型，应用程序请求了无法遵守的游标类型。代之以使用另一种游标类型。
01S02 服务器未遵守数据包大小更改，使用了服务器大小。 应用程序请求了无法为 SQL Server 所支持的非默认数据包大小。代之以使用服务器默认大小。
01S02 数据包大小已更改。 应用程序请求了非默认数据包大小，超出了允许的大小限制。根据所请求的大小是过大，还是过小，代之以使用最小的或最大的数据包大小。
01S02 登录超时已更改。 应用程序请求了一个过长的登录超时。代之以使用最大的登录超时。
07006 不允许使用 bcp_moretext 进行转换。 使用 bcp_moretext 的应用程序与列类型必须具有相同的字段类型。
08004 服务器拒绝连接；已拒绝对所选数据库的访问。 数据库不存在，或用户不具有对该数据库的访问权限。
08004 服务器拒绝连接；不支持所指定的语言。 语言名无效，或未在 SQL Server 上安装该语言。
HY024 数据库无效或无法访问。 数据库不存在，或用户不具有对该数据库的访问权限。
IM006 服务器不支持数据包大小更改，使用默认值。 应用程序请求了 SQL Server 不支持的非默认数据包大小。使用了客户默认大小。
HY000 所有绑定列都是只读的。 必须是可升级的列，以使用 SQLSetPos 或 SQLBulkOperations 更改或插入行。
HY000 已检测到一个旧 netlib (%s)。请删除并重新启动应用程序。 正在装载的 netlib 已过期。驱动程序请求一个较新的 netlib。
问题可能出在应用程序当前目录中的 netlib，正在装载的是这个 netlib，而不是系统目录中的那个。也可能是该 netlib 安装不当或已损坏。如果错误文本中所指定的 netlib 存在于 Windows 系统目录外的其它地方，请将其删除。如果 netlib 只存在于系统目录中，在客户端安装客户实用工具，然后重新启动应用程序。
HY000 尝试将 NULL 值大容量复制到不接受 NULL 值的 Server 列中。 字段包含 NULL 值，但列不允许 NULL 值。
HY000 尝试将过大的列大容量复制到 SQL Server。 为列提供的长度大于表中的列定义。
HY000 尝试读取 BCP 格式文件的未知版本。 bcp 格式文件中的标题行采用了不可识别的版本。
HY000 错误的大容量复制方向。必须是 IN 或者 OUT。 bcp_init 调用没有为 eDirection 参数指定有效的方向。
HY000 错误的终止符。 bcp_bind 中提供的终止符字符串无效。
HY000 Bcp 主文件必须至少包含一列。 未选定任何要装载的列。
HY000 无法生成 SSPI 上下文。 驱动程序无法获得集成安全性所要求的 SSPI 上下文。本机错误将包含该 Win32 错误代码。
HY000 无法初始化 SSPI 包。 驱动程序无法获得集成安全性所要求的 SSPI 上下文。本机错误将包含该 Win32 错误代码。
HY000 通讯模块无效。未正确安装驱动程序。 网络库 .dll 已损坏。在客户端安装客户实用工具，然后重新启动应用程序。
HY000 连接忙，结果针对另一个 hstmt。 SQL Server ODBC 驱动程序只允许一个活动的 hstmt。有关更多信息，请参见使用默认结果集。
HY000 未对 BCP 启用连接。 使用 BCP API 的应用程序必须在连接之前设置 SQLSetConnectAttr 或 SQL_SS_COPT_BCP 特性。
HY000 关闭连接时失败。 网络库中的 ConnectionClose 函数失败。此问题通常是由网络或 SQL Server 问题引起的。
HY000 对于 BCP，必须对所有变长数据指定长度前缀或终止符。 用 SQL_VARYLEN_DATA 调用了 bcp_bind，但未指定前缀长度或终止符。
HY000 只有在复制到服务器中时，才能跳过主文件列。 bcp out 格式文件指定应跳过列。不允许进行这种指定。创建一个视图，其中只包含所需列和该视图的 bcp out，或使用 -Q 标志提供一个只选择所需列的 SELECT 语句。
HY000 在 BCP 格式文件中找到不正确的主列号。 格式文件所包含的列号大于表中的列数。
HY000 在读取 bcp 数据文件时发生 I/O 错误。
HY000 在读取 BCP 格式文件时发生 I/O 错误。
HY000 写入 bcp 数据文件时发生 I/O 错误。
HY000 在写入 bcp 错误文件时发生 I/O 错误。
HY000 无效选项。 到 bcp_control 的 eOption 参数无效。
HY000 默认参数后面不允许有非默认参数。 在任何已用默认值进行指定的参数后面，存储过程的参数不能有非默认值。
HY000 没有足够的列绑定。 对于 bcp out，未绑定表的所有列。创建一个视图，其中只包含所需列和该视图的 bcp out，或使用 -Q 标志提供一个只选择所需列的 SELECT 语句。
HY000 ODBC BCP/驱动程序版本不匹配。 Sqlsrv32.dll 和 Odbcbcp.dll .dll 不具有相同的版本。在客户端安装客户实用工具，然后重新启动应用程序。
HY000 TDS 流中发生协议错误。 服务器的 TDS 流无效。此问题一般是由 SQL Server 问题引起的。请查看SQL Server 错误日志。
HY000 表中包含的行数小于第一个行计数。 提供了起始行号，但服务器上的表未包含那些行数。未向主文件复制任何行。
HY000 表中包含的行数小于最后一个行计数。 提供了结束行号，但服务器上的表未包含那些行数。
HY000 表没有 text/image 列。 调用了 bcp_moretext，但表不包含任何 text 或 image 列。
HY000 TDS 缓冲区长度过大。 服务器的 TDS 流无效。此问题一般是由 SQL Server 问题引起的。请查看SQL Server 错误日志。
HY000 文本列数据不完整。 bcp_moretext 所提供的长度的总和与 bcp_bind 或 bcp_collen 中所提供的长度不匹配。
HY000 BCP 主文件包含的行数小于第一个行计数。 提供了起始行号，但主文件未包含那些行数。未装载任何行。
HY000 行长度超过了 SQL Server 所允许的最大长度。 行的数据长度的总和大于最大行大小。
HY000 无法在服务器上找到完成此操作所需的存储过程（用 SQL Server 提供）。请与系统管理员联系。 通过执行 \Msqql\Install\Instcat.sql 安装 ODBC 目录存储过程。
HY000 无法装载通讯模块。未正确安装驱动程序。 此客户端上不存在为该连接指定的网络库 .dll。在客户端安装客户实用工具，然后重新启动应用程序。
HY000 无法打开 BCP 主数据文件。 在 bcp_init 调用中指定的文件名不存在，或已由另一个应用程序打开。
HY000 无法打开 BCP 错误文件。 在 bcp_init 调用中指定的错误文件名不存在，或已由另一个应用程序打开。
HY000 无法读取驱动程序版本。 驱动程序无法在其 .DLL 中读取版本块。在客户端安装客户实用工具，然后重新启动应用程序。
HY000 在 BCP 数据文件中遇到意外 EOF。 在执行 bcp in 操作过程中，在处理最后一行的过程中，检测到了文件结尾。通常，这是由于原始表和正在装载的表具有不同的列数、类型、为空性或大小而造成的。
HY000 Unicode 转换失败。 在和 Unicode 字符串之间进行转换时出错。本机错误将包含该 Win32 错误代码。
HY000 Unicode 转换失败。必须在客户系统上安装 SQL server 代码页。 服务器代码页必须在客户端存在，方能执行正确的操作。清除 DSN 的”自动转换”复选框，或在客户端安装服务器的代码页。运行 EXEC sp_server_info 18 可以确定服务器代码页。
HY000 从 SQL Server 接收到未知的令牌环。 服务器的 TDS 流无效。此错误一般是由服务器上的问题引起的。请查看SQL Server 错误日志。
HY000 警告:部分插入/更新。插入或更新 text 或 image 列不成功。 在插入或更新 text、image 或 ntext 列的过程中发生了错误。该列将包含不正确的数据。如果可能，请回滚事务。