Apêndice A: Códigos de erro ODBC
Este tópico discute valores SQLSTATE para ODBC 3. x. Para obter mais informações sobre o ODBC 3. x valores SQLSTATE, consulte Mapeamentos SQLSTATE.
SQLGetDiagRec ou SQLGetDiagField retorna valores SQLSTATE conforme definido pelo Open Group Gerenciamento de Dados: linguagem SQL (SQL), Versão 2 (março de 1995). Os valores SQLSTATE são cadeias de caracteres que contêm cinco caracteres. A tabela a seguir lista valores SQLSTATE que um driver pode retornar para SQLGetDiagRec.
O valor da cadeia de caracteres retornado para um SQLSTATE consiste em um valor de classe de dois caracteres seguido por um valor de subclasse de três caracteres. Um valor de classe de "01" indica um aviso e é acompanhado por um código de retorno de SQL_SUCCESS_WITH_INFO. Valores de classe diferentes de "01", exceto a classe "IM", indicam um erro e são acompanhados por um valor retornado de SQL_ERROR. A classe "IM" é específica para avisos e erros que derivam da implementação do próprio ODBC. O valor de subclasse "000" em qualquer classe indica que não há subclasse para esse SQLSTATE. A atribuição de valores de classe e subclasse é definida pelo SQL-92.
Observação
Embora a execução bem-sucedida de uma função normalmente seja indicada por um valor retornado de SQL_SUCCESS, o SQLSTATE 00000 também indica êxito.
| SQLSTATE | Erro | Pode ser retornado de |
|---|---|---|
| 01000 | Aviso geral | Todas as funções ODBC, exceto: Sqlerror SQLGetDiagField SQLGetDiagRec |
| 01001 | Conflito de operação do cursor | SQLExecDirect SQLExecute SQLParamData SQLSetPos |
| 01002 | Erro de desconexão | Sqldisconnect |
| 01003 | Valor NULL eliminado na função set | SQLExecDirect SQLExecute SQLParamData |
| 01004 | Dados de cadeia de caracteres, truncados à direita | SQLBrowseConnect SQLBulkOperations SQLColAttribute SQLDataSources SQLDescribeCol SQLDriverConnect SQLDrivers SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLGetConnectAttr SQLGetCursorName SQLGetData SQLGetDescField SQLGetDescRec SQLGetEnvAttr SQLGetInfo SQLGetStmtAttr SQLNative Sql SQLParamData SQLPutData Sqlsetcursorname |
| 01006 | Privilégio não revogado | SQLExecDirect SQLExecute SQLParamData |
| 01007 | Privilégio não concedido | SQLExecDirect SQLExecute SQLParamData |
| 01S00 | Atributo de cadeia de conexão inválido | SQLBrowseConnect SQLDriverConnec |
| 01S01 | Erro na linha | SQLBulkOperations Sqlextendedfetch SQLSetPos |
| 01S02 | Valor da opção alterado | SQLBrowseConnect SQLConnect SQLDriverConnect SQLExecDirect SQLExecute SQLParamData SQLPrepare SQLSetConnectAttr SQLSetDescField SQLSetEnvAttr SQLSetStmtAttr |
| 01S06 | Tentativa de busca antes que o conjunto de resultados retornasse o primeiro conjunto de linhas | Sqlextendedfetch SQLFetchScroll |
| 01S07 | Truncamento fracionário | SQLBulkOperations SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLGetData SQLParamData SQLSetPos |
| 01S08 | Erro ao salvar o DSN do Arquivo | SQLDriverConnect |
| 01S09 | Palavra-chave inválida | SQLDriverConnect |
| 07001 | Número incorreto de parâmetros | SQLExecDirect SQLExecute |
| 07002 | Campo COUNT incorreto | SQLExecDirect SQLExecute SQLParamData |
| 07005 | Instrução preparada não é uma especificação de cursor | SQLColAttribute SQLDescribeCol |
| 07006 | Violação de atributo de tipo de dados restrito | SQLBindCol SQLBindParameter SQLBulkOperations SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLGetData SQLParamData SQLPutData SQLSetPos |
| 07009 | Índice de descritor inválido | SQLBindCol SQLBindParameter SQLBulkOperations SQLColAttribute SQLDescribeCol SQLDescribeParam SQLFetch SQLFetchScroll SQLGetData SQLGetDescField SQLGetDescRec SQLParamData SQLSetDescField SQLSetDescRecSQLSetPos |
| 07S01 | Uso inválido do parâmetro padrão | SQLExecDirect SQLExecute SQLParamData SQLPutData |
| 08001 | O cliente não consegue estabelecer a conexão | SQLBrowseConnect SQLConnect SQLDriverConnect |
| 08002 | Nome da conexão em uso | SQLBrowseConnect SQLConnect SQLDriverConnect SQLSetConnectAttr |
| 08003 | Conexão não aberta | SQLAllocHandle Sqldisconnect SQLEndTran SQLGetConnectAttr SQLGetInfo SQLNativeSql SQLSetConnectAttr |
| 08004 | O servidor rejeitou a conexão | SQLBrowseConnect SQLConnect SQLDriverConnect |
| 08007 | Falha de conexão durante a transação | SQLEndTran |
| 08S01 | Falha no link de comunicação | SQLBrowseConnect SQLColumnPrivileges SQLColumns SQLConnect SQLCopyDesc SQLDescribeCol SQLDescribeParam SQLDriverConnect SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLForeignKeys SQLGetConnectAttr SQLGetData SQLGetDescField SQLGetDescRec SQLGetFunctions SQLGetInfo SQLGetTypeInfo SQLMoreResults SQLNativeSql SQLNumParams SQLNumResultCols SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLPutData SQLSetConnectAttr SQLSetDescField SQLSetDescRec SQLSetEnvAttr SQLSetStmtAttr SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| 21S01 | Inserir lista de valores não corresponde à lista de colunas | SQLExecDirect SQLPrepare |
| 21S02 | O grau da tabela derivada não corresponde à lista de colunas | SQLBulkOperations SQLExecDirect SQLExecute SQLParamData SQLPrepare SQLSetPos |
| 22001 | Dados de cadeia de caracteres, truncados à direita | SQLBulkOperations SQLExecDirect SQLExecute SQLFetch SQLFetchScroll SQLParamData SQLPutData SQLSetDescField SQLSetPos |
| 22002 | Variável de indicador necessária, mas não fornecida | SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLGetData SQLParamData |
| 22003 | Valor numérico fora do intervalo | SQLBulkOperations SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLGetData SQLGetInfo SQLParamData SQLPutData SQLSetPos |
| 22007 | Formato de datetime inválido | SQLBulkOperations SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLGetData SQLParamData SQLPutData SQLSetPos |
| 22008 | Estouro do campo datetime | SQLBulkOperations SQLExecDirect QLParamData SQLPutData |
| 22012 | Divisão por zero | SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLGetData SQLPutData |
| 22015 | Estouro de campo de intervalo | SQLBulkOperations SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLGetData SQLParamData SQLPutData SQLSetPos |
| 22018 | Valor de caractere inválido para especificação de conversão | SQLBulkOperations SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLGetData SQLParamData SQLPutData SQLSetPos |
| 22019 | Caractere de escape inválido | SQLExecDirect SQLExecute SQLPrepare |
| 22025 | Sequência de escape inválida | SQLExecDirect SQLExecute SQLPrepare |
| 22026 | Incompatibilidade de comprimento de dados String | SQLParamData |
| 23000 | Violação da restrição de integridade | SQLBulkOperations SQLExecDirect SQLExecute SQLParamData SQLSetPos |
| 24.000 | Estado de cursor inválido | SQLBulkOperations SQLCloseCursor SQLColumnPrivileges SQLColumns SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLForeignKeys SQLGetData SQLGetStmtAttr SQLGetTypeInfo SQLNativeSql SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLSetConnectAttr Sqlsetcursorname SQLSetPos SQLSetStmtAttr SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| 25000 | Estado de transação inválido | Sqldisconnect |
| 25S01 | Estado da transação | SQLEndTran |
| 25S02 | A transação ainda está ativa | SQLEndTran |
| 25S03 | A transação é revertida | SQLEndTran |
| 28000 | Especificação de autorização inválida | SQLBrowseConnect SQLConnect SQLDriverConnect |
| 34000 | Nome de cursor inválido | SQLExecDirect SQLPrepare Sqlsetcursorname |
| 3C000 | Nome do cursor duplicado | Sqlsetcursorname |
| 3D000 | Nome de catálogo inválido | SQLExecDirect SQLPrepare SQLSetConnectAttr |
| 3F000 | Nome de esquema inválido | SQLExecDirect SQLPrepare |
| 40001 | Falha na serialização | SQLBulkOperations SQLColumnPrivileges SQLColumns SQLEndTran SQLExecDirect SQLExecute SQLFetch SQLFetchScroll SQLForeignKeys SQLGetTypeInfo SQLMoreResults SQLParamData SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLSetPos SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| 40002 | Violação da restrição de integridade | SQLEndTran |
| 40003 | Conclusão da instrução desconhecida | SQLBulkOperations SQLColumnPrivileges SQLColumns SQLExecDirect SQLExecute SQLFetch SQLFetchScroll SQLForeignKeys SQLGetTypeInfo SQLMoreResults SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLParamData SQLSetPos SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| 42000 | Erro de sintaxe ou violação de acesso | SQLBulkOperations SQLExecDirect SQLExecute SQLParamData SQLPrepare SQLSetPos |
| 42S01 | A tabela ou exibição base já existe | SQLExecDirect SQLPrepare |
| 42S02 | Tabela base ou exibição não encontrada | SQLExecDirect SQLPrepare |
| 42S11 | O índice já existe | SQLExecDirect SQLPrepare |
| 42S12 | Índice não encontrado | SQLExecDirect SQLPrepare |
| 42S21 | A coluna já existe | SQLExecDirect SQLPrepare |
| 42S22 | Coluna não encontrada | SQLExecDirect SQLPrepare |
| 44000 | Violação COM OPÇÃO DE VERIFICAÇÃO | SQLBulkOperations SQLExecDirect SQLExecute SQLParamData SQLSetPos |
| HY000 | Erro geral | Todas as funções ODBC, exceto: Sqlerror SQLGetDiagField SQLGetDiagRec |
| HY001 | Erro de alocação de memória | Todas as funções ODBC, exceto: Sqlerror SQLGetDiagField SQLGetDiagRec |
| HY003 | Tipo de buffer de aplicativo inválido | SQLBindCol SQLBindParameter SQLGetData |
| HY004 | Tipo de dados SQL inválido | SQLBindParameter SQLGetTypeInfo |
| HY007 | A instrução associada não está preparada | SQLCopyDesc SQLGetDescField SQLGetDescRec |
| HY008 | Operação cancelada | Todas as funções ODBC que podem ser processadas de forma assíncrona: SQLBrowseConnect SQLBulkOperations SQLColAttribute SQLColumnPrivileges SQLColumns SQLConnect SQLDescribeCol SQLDescribeParam Sqldisconnect SQLDriverConnect SQLEndTran SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLForeignKeys SQLGetData SQLGetTypeInfo SQLMoreResults SQLNumParams SQLNumResultCols SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLPutData SQLSetConnectAttr SQLSetPos SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HY009 | Uso inválido de ponteiro nulo | SQLAllocHandle SQLBindParameter SQLBulkOperations SQLColumnPrivileges SQLColumns SQLExecDirect SQLForeignKeys SQLGetCursorName SQLGetData SQLGetFunctions SQLNativeSql SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLPutData SQLSetConnectAttr Sqlsetcursorname SQLSetEnvAttr SQLSetStmtAttr SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HY010 | Erro de sequência de funções | SQLAllocHandle SQLBindCol SQLBindParameter SQLBulkOperations SQLCloseCursor SQLColAttribute SQLColumnPrivileges SQLColumns SQLCopyDesc SQLDescribeCol SQLDescribeParam Sqldisconnect SQLEndTran SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLForeignKeys SQLFreeHandle SQLFreeStmt SQLGetConnectAttr SQLGetCursorName SQLGetData SQLGetDescField SQLGetDescRec SQLGetFunctions SQLGetStmtAttr SQLGetTypeInfo SQLMoreResults SQLNumParams SQLNumResultCols SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLPutData SQLRowCount SQLSetConnectAttr Sqlsetcursorname SQLSetDescField SQLSetEnvAttr SQLSetDescRec SQLSetPos SQLSetStmtAttr SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HY011 | O atributo não pode ser definido agora | SQLBulkOperations SQLParamData QLSetPos SQLSetStmtAttr |
| HY012 | Código de operação de transação inválido | SQLEndTran |
| HY013 | Erro de gerenciamento de memória | Todas as funções ODBC, exceto: SQLGetDiagField SQLGetDiagRec |
| HY014 | Limite no número de identificadores excedido | SQLAllocHandle |
| HY015 | Nenhum nome de cursor disponível | SQLGetCursorName |
| HY016 | Não é possível modificar um descritor de linha de implementação | SQLCopyDesc SQLSetDescField SQLSetDescRec |
| HY017 | Uso inválido de um identificador de descritor alocado automaticamente | SQLFreeHandle SQLSetStmtAttr |
| HY018 | Solicitação de cancelamento recusada pelo servidor | SQLCancel |
| HY019 | Dados não-caracteres e não binários enviados em partes | SQLPutData |
| HY020 | Tentar concatenar um valor nulo | SQLPutData |
| HY021 | Informações inconsistentes do descritor | SQLBindParameter SQLCopyDesc SQLGetDescField SQLSetDescField SQLSetDescRec |
| HY024 | Valor de atributo inválido | SQLSetConnectAttr SQLSetEnvAttr SQLSetStmtAttr |
| HY090 | Comprimento de buffer ou cadeia de caracteres inválida | SQLBindCol SQLBindParameter SQLBrowseConnect SQLBulkOperations SQLColAttribute SQLColumnPrivileges SQLColumns SQLConnect SQLDataSources SQLDescribeCol SQLDriverConnect SQLDrivers SQLExecDirect SQLExecute SQLFetch SQLFetchScroll SQLForeignKeys SQLGetConnectAttr SQLGetCursorName SQLGetData SQLGetDescField SQLGetInfo SQLGetStmtAttr SQLNativeSql SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLPutData SQLSetConnectAttr Sqlsetcursorname SQLSetDescField SQLSetDescRec SQLSetEnvAttr SQLSetStmtAttr SQLSetPos SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HY091 | Identificador de campo de descritor inválido | SQLColAttribute SQLGetDescField SQLSetDescField |
| HY092 | Identificador de atributo/opção inválido | SQLAllocHandle QLBulkOperations SQLCopyDesc SQLDriverConnect SQLEndTran SQLFreeStmt SQLGetConnectAttr SQLGetEnvAttr QLParamData SQLSetConnectAttr SQLSetDescField SQLSetEnvAttr SQLSetPos SQLSetStmtAttr |
| HY095 | Tipo de função fora do intervalo | SQLGetFunctions |
| HY096 | Tipo de informação inválido | SQLGetInfo |
| HY097 | Tipo de coluna fora do intervalo | SQLSpecialColumns |
| HY098 | Tipo de escopo fora do intervalo | SQLSpecialColumns |
| HY099 | Tipo anulável fora do intervalo | SQLSpecialColumns |
| HY100 | Tipo de opção de exclusividade fora do intervalo | SQLStatistics |
| HY101 | Tipo de opção de precisão fora do intervalo | SQLStatistics |
| HY103 | Código de recuperação inválido | SQLDataSources SQLDrivers |
| HY104 | Valor de escala ou precisão inválido | SQLBindParameter |
| HY105 | Tipo de parâmetro inválido | SQLBindParameter SQLExecDirect SQLExecute SQLParamData SQLSetDescField |
| HY106 | Buscar tipo fora do intervalo | Sqlextendedfetch SQLFetchScroll |
| HY107 | Valor de linha fora do intervalo | Sqlextendedfetch SQLFetch SQLFetchScroll SQLSetPos |
| HY109 | Posição inválida do cursor | SQLExecDirect SQLExecute SQLGetData SQLGetStmtAttr SQLNativeSql SQLParamData SQLSetPos |
| HY110 | Conclusão inválida do driver | SQLDriverConnect |
| HY111 | Valor de indicador inválido | Sqlextendedfetch SQLFetchScroll |
| HYC00 | Recurso opcional não implementado | SQLBindCol SQLBindParameter SQLBulkOperations SQLColAttribute SQLColumnPrivileges SQLColumns SQLDriverConnect SQLEndTran SQLExecDirect SQLExecute Sqlextendedfetch SQLFetch SQLFetchScroll SQLForeignKeys SQLGetConnectAttr SQLGetData SQLGetEnvAttr SQLGetInfo SQLGetStmtAttr SQLGetTypeInfo SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLSetConnectAttr SQLSetEnvAttr SQLSetPos SQLSetStmtAttr SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HYT00 | Tempo limite esgotado | SQLBrowseConnect SQLBulkOperations SQLColumnPrivileges SQLColumns SQLConnect SQLDriverConnect SQLExecDirect SQLExecute Sqlextendedfetch SQLForeignKeys SQLGetTypeInfo SQLParamData SQLPrepare SQLPrimaryKeys SQLProcedureColumns SQLProcedures SQLSetPos SQLSpecialColumns SQLStatistics SQLTablePrivileges SQLTables |
| HYT01 | O tempo limite da conexão expirou | Todas as funções ODBC, exceto: SQLDrivers SQLDataSources SQLGetEnvAttr SQLSetEnvAttr |
| IM001 | O driver não dá suporte a essa função | Todas as funções ODBC, exceto: SQLAllocHandle SQLDataSources SQLDrivers SQLFreeHandle SQLGetFunctions |
| IM002 | Nome da fonte de dados não encontrado e nenhum driver padrão especificado | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM003 | Não foi possível carregar o driver especificado | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM004 | Falha no SQLAllocHandle do driver no SQL_HANDLE_ENV | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM005 | Falha no SQLAllocHandle do driver no SQL_HANDLE_DBC | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM006 | Falha no SQLSetConnectAttr do driver | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM007 | Nenhuma fonte de dados ou driver especificado; caixa de diálogo proibida | SQLDriverConnect |
| IM008 | Falha na caixa de diálogo | SQLDriverConnect |
| IM009 | Não é possível carregar a DLL de tradução | SQLBrowseConnect SQLConnect SQLDriverConnect SQLSetConnectAttr |
| IM010 | Nome da fonte de dados muito longo | SQLBrowseConnect SQLConnect SQLDriverConnect |
| IM011 | Nome do driver muito longo | SQLBrowseConnect SQLDriverConnect |
| IM012 | Erro de sintaxe da palavra-chave DRIVER | SQLBrowseConnect SQLDriverConnect |
| IM013 | Erro de arquivo de rastreamento | Todas as funções ODBC. |
| IM014 | Nome inválido do DSN de Arquivo | SQLDriverConnect |
| IM015 | Fonte de dados de arquivo corrompido | SQLDriverConnect |