Códigos de erro SQLSTATE
Aplica-se a: Databricks SQL
Databricks Runtime 12.2e acima
Todas as classes de erro retornadas pela Databricks estão associadas a um caractere de 5 caracteres SQLSTATE
.
Um SQLSTATE
é uma codificação padrão do SQL para condições de erro comumente usadas por JDBC
, ODBC
e outras APIs de cliente.
Um SQLSTATE
consiste em duas partes: uma classe de dois caracteres e uma subclasse de três caracteres.
Cada caractere deve ter um dígito '0'
a '9'
ou 'A'
a 'Z'
.
Embora muitos valores SQLSTATE
sejam prescritos pelo padrão SQL, outros são comuns nas indústrias, específicos para Spark, ou Databricks.
Quando necessário, o Spark e o Databricks usam a classe 'KD'
e os intervalos da subclasse 'K**'
para SQLSTATEs personalizados.
A classe 'XX'
é usada para erros internos que justificam um relatório de bug.
Para obter uma lista ordenada das classes de erro, consulte: Tratamento de erros na Databricks
A Databricks usa as seguintes classes SQLSTATE
:
Classe 07
: erro de SQL dinâmico
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| a cláusula de uso não corresponde às especificações de parâmetros dinâmicos |
| A opção especificada em PREPARE ou EXECUTE não é válida. |
Classe 08
: exceção de conexão
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| exceção de conexão |
| O cliente SQL não consegue estabelecer uma conexão SQL |
| conexão não existe |
| falha de conexão |
| servidor ocupado |
Classe 0A
: recurso não suportado
Classe 0B
: início de transação inválido
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| início de transação inválido |
Classe 0K
: resinalizar quando o manipulador não está ativo
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| resinalizar quando o manipulador não está ativo |
Classe 0N
: Erro de mapeamento SQL/XML
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| Erro de mapeamento SQL/XML |
Classe 21
: violação de cardinalidade
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| violação de cardinalidade |
| A mesma linha de uma tabela não pode ser o alvo de mais de uma operação de atualização, exclusão ou inserção. |
| A lista de valores de inserção não corresponde à lista de colunas |
Classe 22
: exceção de dados
Classe 23
: violação de restrição de integridade
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| restringir a violação |
| Um valor de inserção ou atualização é nulo, mas a coluna não pode conter valores nulos. |
| Ocorreu uma violação da restrição imposta por um índice exclusivo ou por uma restrição exclusiva. |
| A restrição de verificação não pode ser adicionada, pois a tabela contém linhas que não satisfazem a definição da restrição. |
| violação da cardinalidade da mesclagem |
Classe 25
: estado de transação inválido
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| estado de transação inválido |
|
Classe 28
: especificação de autorização inválida
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| especificação de autorização inválida |
Classe 2B
: ainda existem descritores de privilégios dependentes
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| objetos dependentes ainda existem |
Classe 2D
: encerramento de transação inválido
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| SQL commit ou ROLLBACK são inválidos no ambiente operacional atual. |
| O gancho do post commit falhou. |
Classe 35
: número de condição inválido
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| número de condição inválido |
Classe 38
: exceção de rotina externa
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| exceção de rotina externa |
Classe 39
: exceção de invocação de rotina externa
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| exceção de invocação de rotina externa |
Classe 3D
: nome de catálogo inválido
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| nome de catálogo inválido |
Classe 3F
: nome de esquema inválido
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| nome de esquema inválido |
Classe 40
: reversão de transações
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| reversão de transações |
Classe 42
: erro de sintaxe ou violação da regra de acesso
Classe 44
: com violação da opção de verificação
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| com violação da opção de verificação |
Classe 46
: Java DDL 1
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| nome de classe não resolvido |
| recurso não suportado |
| nome de coluna inválido |
Classe 51
: Estado de aplicativo inválido
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| Estado do aplicativo inválido |
| Um objeto não pode ser usado porque foi marcado como inoperante. |
Aula 53
: recurso insuficiente
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| recurso insuficiente |
| disco cheio |
| sem memória |
Classe 54
: limite do programa excedido
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| limite do programa excedido |
| |
| A declaração é muito longa ou muito complexa. |
| As sequências de resultados são muito longas. |
| muitos argumentos |
| A profundidade máxima da visualização aninhada foi excedida. |
| Excedido o número máximo de UDF no plano de consulta. |
| A contagem máxima de objetos na sessão foi excedida. |
Classe 55
: objeto que não está no estado de pré-requisito
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| objeto que não está no estado de pré-requisito |
| |
| O objeto está em um estado inválido para as operações. |
Classe 56
: Erros diversos de SQL ou de produto
Classe 57
: intervenção do operador
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| intervenção do operador |
| Um recurso que não é do banco de dados não está disponível. Isso não afetará a execução bem-sucedida das declarações subsequentes. |
| Tempo limite de execução da consulta |
Classe 58
: Erro do sistema
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| Erro do sistema |
| Erro de E/S |
|
Classe 82
: sem memória
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| sem memória (não foi possível alocar) |
Classe F0
: erro no arquivo de configuração
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| erro no arquivo de configuração |
Classe HV
: Condição específica do FDW
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| Condição específica do FDW |
| identificador de campo descritor inválido |
Classe HY
: Condição específica da CLI
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| Condição específica da CLI |
| operações canceladas |
| posição inválida do cursor |
Classe KD
: erros específicos da fonte de dados
Classe P0
: erro de lógica processual
SQLSTATE | Descrição e condições de erro de emissão |
---|---|
| exceção de aumento |