Mapeamentos de SQLSTATE
Este tópico discute os valores SQLSTATE para ODBC 2.x e ODBC 3.x. Para obter mais informações sobre valores SQLSTATE ODBC 3.x, confira o Apêndice A: Códigos de erro ODBC.
No ODBC 3.x, SQLSTATEs HYxxx são retornados em vez de S1xxx, e SQLSTATEs 42Sxx são retornados em vez de S00XX. Isso foi feito para cumprir as normas Open Group e ISO. Em muitos casos, o mapeamento não é de um para um porque os padrões redefiniram a interpretação de vários SQLSTATEs.
Quando um aplicativo ODBC 2.x é atualizado para um aplicativo ODBC 3.x, o aplicativo precisa ser alterado para esperar SQLSTATEs ODBC 3.x em vez de SQLSTATEs ODBC 2.x. A tabela a seguir lista os SQLSTATEs ODBC 3.x para os quais cada SQLSTATE ODBC 2.x é mapeado.
Quando o atributo de ambiente SQL_ATTR_ODBC_VERSION é definido como SQL_OV_ODBC2, o driver posta SQLSTATEs ODBC 2.x em vez de SQLSTATEs ODBC 3.x quando SQLGetDiagField ou SQLGetDiagRec é chamado. Um mapeamento específico pode ser determinado observando o ODBC 2.x SQLSTATE na coluna 1 da tabela a seguir que corresponde ao ODBC 3.x SQLSTATE na coluna 2.
| ODBC 2.x SQLSTATE | ODBC 3.x SQLSTATE | Comentários |
|---|---|---|
| 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 é mapeado para ODBC 3.x SQLSTATE 07009 se a função subjacente for SQLBindCol, SQLColAttribute, SQLExtendedFetch, SQLFetch, SQLFetchScroll ou SQLGetData. |
| S1003 | HY003 | |
| S1004 | HY004 | |
| S1008 | HY008 | |
| S1009 | HY009 | Retornado para um uso inválido de um ponteiro nulo. |
| S1009 | HY024 | Retornado para um valor do atributo inválido. |
| S1009 | HY092 | Retornado para atualizar ou excluir dados por uma chamada para SQLSetPos ou adicionar, atualizar ou excluir dados por uma chamada para SQLBulkOperations quando a simultaneidade é somente leitura. |
| S1010 | HY007 HY010 | SQLSTATE S1010 é mapeado para SQLSTATE HY007 quando o SQLDescribeCol é chamado antes de chamar SQLPrepare, SQLExecDirect ou uma função de catálogo para o StatementHandle. Caso contrário, SQLSTATE S1010 é mapeado para SQLSTATE HY010. |
| S1011 | HY011 | |
| S1012 | HY012 | |
| S1090 | HY090 | |
| S1091 | HY091 | |
| S1092 | HY092 | |
| S1093 | 07009 | ODBC 3.x SQLSTATE 07009 é mapeado para ODBC 2.x SQLSTATE S1093 se a função subjacente for SQLBindParameter ou 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 |
Observação
ODBC 3.x SQLSTATE 07008 é mapeado para ODBC 2.x SQLSTATE S1000.