SQLSTATE 매핑

이 항목에서는 ODBC 2.x 및 ODBC 3.x 에 대한 SQLSTATE 값에 대해 설명합니다. ODBC 3.x SQLSTATE 값에 대한 자세한 내용은 부록 A: ODBC 오류 코드를 참조 하세요.

ODBC 3.x에서는 S1xxx 대신 HYxxx SQLSTATE가 반환되고 S00XX 대신 42Sxx SQLSTATE가 반환됩니다. 이는 Open Group 및 ISO 표준에 맞게 수행되었습니다. 대부분의 경우 표준이 여러 SQLSTATE의 해석을 다시 정의했기 때문에 매핑은 일대일이 아닙니다.

ODBC 2.x 애플리케이션을 ODBC 3.x 애플리케이션으로 업그레이드하는 경우 ODBC 2.x SQLSTATE 대신 ODBC 3.x SQLSTATE를 예상하도록 애플리케이션을 변경해야 합니다. 다음 표에서는 각 ODBC 2.x SQLSTATE가 매핑되는 ODBC 3.x SQLSTATE를 나열합니다.

SQL_ATTR_ODBC_VERSION 환경 특성이 SQL_OV_ODBC2 설정되면 드라이버는 SQLGetDiagField 또는 SQLGetDiagRec를 호출할 때 ODBC 3.x SQLSTATE 대신 ODBC 2.x SQLSTATE를 게시합니다. 열 2의 ODBC 3.x SQLSTATE에 해당하는 다음 표의 열 1에 있는 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	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에 매핑됩니다.