Mappages SQLSTATE

Cette rubrique décrit les valeurs SQLSTATE pour ODBC 2.x et ODBC 3.x. Pour plus d’informations sur les valeurs ODBC 3.x SQLSTATE, consultez l’annexe A : Codes d’erreur ODBC.

Dans ODBC 3.x, les SQLSTATEs HYxxx sont retournés au lieu de S1xxx et 42Sxx SQLSTATEs sont retournés au lieu de S00XX. Cela a été fait pour s’aligner sur les normes Open Group et ISO. Dans de nombreux cas, le mappage n’est pas un-à-un, car les normes ont redéfini l’interprétation de plusieurs SQLSTATEs.

Lorsqu’une application ODBC 2.x est mise à niveau vers une application ODBC 3.x , l’application doit être modifiée pour s’attendre à ce qu’ODBC 3.x SQLSTATEs au lieu d’ODBC 2.x SQLSTATEs. Le tableau suivant répertorie les SQLSTATEs ODBC 3.x auxquels chaque SQLSTATE ODBC 2.x est mappé.

Lorsque l’attribut d’environnement SQL_ATTR_ODBC_VERSION est défini sur SQL_OV_ODBC2, le pilote publie les sqlSTATEs ODBC 2.x au lieu d’ODBC 3.x SQLSTATEs lorsque SQLGetDiagField ou SQLGetDiagRec est appelé. Un mappage spécifique peut être déterminé en notant ODBC 2.x SQLSTATE dans la colonne 1 du tableau suivant qui correspond à ODBC 3.x SQLSTATE dans la colonne 2.

ODBC 2.x SQLSTATE	ODBC 3.x SQLSTATE	Commentaires
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	ODBC 2.x SQLSTATE S1002 est mappé à ODBC 3.x SQLSTATE 07009 si la fonction sous-jacente est SQLBindCol, SQLColAttribute, SQLExtendedFetch, SQLFetch, SQLFetchScroll ou SQLGetData.
S1003	HY003
S1004	HY004
S1008	HY008
S1009	HY009	Retourné pour une utilisation non valide d’un pointeur Null.
S1009	HY024	Retourné pour une valeur d’attribut non valide.
S1009	HY092	Retourné pour la mise à jour ou la suppression de données par un appel à SQLSetPos, ou en ajoutant, en mettant à jour ou en supprimant des données par un appel à SQLBulkOperations, lorsque l’accès concurrentiel est en lecture seule.
S1010	HY007 HY010	SQLSTATE S1010 est mappé à SQLSTATE HY007 lorsque SQLDescribeCol est appelé avant d’appeler SQLPrepare, SQLExecDirect ou une fonction de catalogue pour StatementHandle. Sinon, SQLSTATE S1010 est mappé à SQLSTATE HY010.
S1011	HY011
S1012	HY012
S1090	HY090
S1091	HY091
S1092	HY092
S1093	07009	ODBC 3.x SQLSTATE 07009 est mappé à ODBC 2.x SQLSTATE S1093 si la fonction sous-jacente est SQLBindParameter ou SQLDescribeParam.
S1096	HY096
S1097	HY097
S1098	HY098
S1099	HY0999
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

Remarque

ODBC 3.x SQLSTATE 07008 est mappé à ODBC 2.x SQLSTATE S1000.