SQLSTATE 映射

本主题讨论 ODBC 2.x 和 ODBC 3.x 的 SQLSTATE 值。 有关 ODBC 3.x SQLSTATE 值的详细信息，请参阅附录 A：ODBC 错误代码。

在 ODBC 3.x 中，返回 HYxxx SQLSTATE 而不是 S1xxx，返回 42Sxx SQLSTATE 而不是 S00XX。 这样做是为了符合开放组和 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 列中备注与第 2 列中 ODBC 3.x SQLSTATE 对应的 ODBC 2.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	因无效使用空指针而返回。
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。