Mapping di SQLSTATE

In questo argomento vengono illustrati i valori SQLSTATE per ODBC 2.x e ODBC 3.x. Per altre informazioni sui valori SQLSTATE ODBC 3.x, vedere Appendice A: Codici di errore ODBC.

In ODBC 3.x vengono restituiti SQLSTATE HYxxx anziché S1xxx, mentre vengono restituiti SQLSTATE 42Sxx anziché S00XX. Questa operazione è stata eseguita per allinearsi agli standard Open Group e ISO. In molti casi, il mapping non è in rapporto uno a uno perché gli standard hanno ridefinito l'interpretazione di diversi SQLSTATE.

Quando un'applicazione ODBC 2.x viene aggiornata a un'applicazione ODBC 3.x, l'applicazione deve essere modificata per prevedere SQLSTATE ODBC 3.x anziché SQLSTATE ODBC 2.x. Nella tabella seguente sono elencati gli SQLSTATE ODBC 3.x a cui è mappato ogni SQLSTATE ODBC 2.x.

Quando l'attributo di ambiente SQL_ATTR_ODBC_VERSION è impostato su SQL_OV_ODBC2, il driver pubblica SQLSTATE ODBC 2.x anziché SQLSTATE ODBC 3.x quando vengono chiamati SQLGetDiagField o SQLGetDiagRec. È possibile determinare un mapping specifico notando il SQLSTATE ODBC 2.x nella colonna 1 della tabella seguente corrispondente al SQLSTATE ODBC 3.x nella colonna 2.

ODBC 2.x SQLSTATE	ODBC 3.x SQLSTATE	Commenti
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	SQLSTATE S1002 ODBC 2.x viene mappato a SQLSTATE 07009 ODBC 3.x se la funzione sottostante è SQLBindCol, SQLColAttribute, SQLExtendedFetch, SQLFetch, SQLFetchScroll o SQLGetData.
S1003	HY003
S1004	HY004
S1008	HY008
S1009	HY009	Restituito per un uso non valido di un puntatore Null.
S1009	HY024	Restituito per un valore dell’attributo non valido.
S1009	HY092	Restituito per l'aggiornamento o l'eliminazione di dati tramite una chiamata a SQLSetPos o l'aggiunta, l'aggiornamento o l'eliminazione di dati da una chiamata a SQLBulkOperations, quando la concorrenza è di sola lettura.
S1010	HY007 HY010	SQLSTATE S1010 viene mappato a SQLSTATE HY007 quando SQLDescribeCol viene chiamato prima di chiamare SQLPrepare, SQLExecDirect o una funzione catalogo per StatementHandle. In caso contrario, SQLSTATE S1010 viene mappato a SQLSTATE HY010.
S1011	HY011
S1012	HY012
S1090	HY090
S1091	HY091
S1092	HY092
S1093	07009	SQLSTATE 07009 ODBC 3.x viene mappato a SQLSTATE S1093 ODBC 2.x se la funzione sottostante è SQLBindParameter o SQLDescribeParam.
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

Nota

SQLSTATE 07008 ODBC 3.x è stato mappato a SQLSTATE S1000 ODBC 2.x.