// referência de erro

Códigos de erro do MySQL

Os erros do servidor e cliente MySQL que as pessoas mais enfrentam, cada um com o texto da mensagem, símbolo e SQLSTATE da referência de erros MySQL, o que o erro significa e como corrigi-lo.

Lendo um erro do MySQL

O MySQL relata erros como ERROR 1062 (23000): Duplicate entry '7' for key 'users.PRIMARY'. O número é o código de erro do MySQL, os cinco caracteres entre colchetes são o SQLSTATE, e o resto é a mensagem com seus espaços reservados preenchidos.

Códigos de 1000 até 1999 e de 3000 em diante são gerados pelo servidor. Códigos de 2000 a 2999 são gerados pela biblioteca do cliente, geralmente porque a conexão não pôde ser estabelecida ou foi perdida, então o servidor pode nunca ter visto a instrução.

Executar SHOW WARNINGS; após uma instrução para ver avisos e notas, que usam os mesmos números. Muitos erros de dados, como 1265 ou 1366, são avisos em modos SQL não estritos e erros em modo estrito.

Todos os erros do MySQL nesta referência

79 códigos, 79 com uma descrição completa (linkada). Códigos e mensagens são do Referência de mensagens de erro do MySQL 8.4.

Conexão e cliente

CódigoSignificado
2002 Não é possível conectar pelo socket CR_CONNECTION_ERROR Não é possível conectar ao servidor MySQL local através do socket '%s' (%d)
2003 Não é possível conectar ao servidor MySQL no host CR_CONN_HOST_ERROR Não é possível conectar ao servidor MySQL em '%s:%u' (%d)
2005 Host do servidor MySQL desconhecido CR_UNKNOWN_HOST Host do servidor MySQL desconhecido '%s' (%d)
2006 O servidor MySQL foi embora CR_SERVER_GONE_ERROR O servidor MySQL foi embora
2013 Perda de conexão com o servidor MySQL durante a consulta CR_SERVER_LOST Perda de conexão com o servidor MySQL durante a consulta
2055 Perda de conexão com o servidor MySQL em estágio CR_SERVER_LOST_EXTENDED Perda de conexão com o servidor MySQL na etapa
2026 Erro de conexão SSL CR_SSL_CONNECTION_ERROR Erro de conexão SSL: %s
2059 O plugin de autenticação não pode ser carregado CR_AUTH_PLUGIN_CANNOT_LOAD O plugin de autenticação '%s' não pode ser carregado: %s
2061 O plugin de autenticação relatou erro CR_AUTH_PLUGIN_ERR O plugin de autenticação '%s' relatou erro: %s
1251 O cliente não suporta o protocolo de autenticação ER_NOT_SUPPORTED_AUTH_MODE O cliente não suporta o protocolo de autenticação solicitado pelo servidor; considere atualizar o cliente MySQL
3159 Transporte inseguro proibido ER_SECURE_TRANSPORT_REQUIRED O uso de conexões com transporte inseguro é proibido enquanto --require_secure_transport=ON.
1158 Erro ao ler pacotes de comunicação ER_NET_READ_ERROR Ocorreu um erro ao ler pacotes de comunicação
1159 Ocorreu um tempo limite ao ler pacotes de comunicação ER_NET_READ_INTERRUPTED Ocorreu um tempo limite ao ler pacotes de comunicação
4031 Desconectado pelo servidor por inatividade ER_CLIENT_INTERACTION_TIMEOUT O cliente foi desconectado pelo servidor devido à inatividade. Veja wait_timeout e interactive_timeout para configurar esse comportamento.

Acesso e privilégios

CódigoSignificado
1045 Acesso negado para o usuário ER_ACCESS_DENIED_ERROR Acesso negado para o usuário '%s'@'%s' (usando senha: %s)
1044 Acesso negado para o usuário ao banco de dados ER_DBACCESS_DENIED_ERROR Acesso negado para o usuário '%s'@'%s' ao banco de dados '%s'
1130 Host não está autorizado a se conectar ER_HOST_NOT_PRIVILEGED Host '%s' não está autorizado a se conectar a este servidor MySQL
1698 Acesso negado para o usuário (sem senha) ER_ACCESS_DENIED_NO_PASSWORD_ERROR Acesso negado para o usuário '%s'@'%s'
1142 Comando negado para o usuário na tabela ER_TABLEACCESS_DENIED_ERROR Comando %s negado ao usuário '%s'@'%s' para a tabela '%s'
1143 Comando negado para o usuário na coluna ER_COLUMNACCESS_DENIED_ERROR Comando %s negado ao usuário '%s'@'%s' para a coluna '%s' na tabela '%s'
1227 Acesso negado; você precisa de um privilégio ER_SPECIFIC_ACCESS_DENIED_ERROR Acesso negado; você precisa de (pelo menos um dos) privilégio(s) %s para esta operação
1396 Falha na operação CREATE USER ER_CANNOT_USER Falha na operação %s para %s
1419 Privilégio SUPER necessário com log binário ER_BINLOG_CREATE_ROUTINE_NEED_SUPER Você não tem o privilégio SUPER e o log binário está ativado (você *talvez queira* usar a variável menos segura log_bin_trust_function_creators)
1449 Usuário definidor não existe ER_NO_SUCH_USER O usuário especificado como definidor ('%s'@'%s') não existe

Sintaxe e instruções

CódigoSignificado
1064 Você tem um erro na sintaxe SQL ER_PARSE_ERROR %s próximo de '%s' na linha %d
1149 Erro de sintaxe SQL ER_SYNTAX_ERROR Você tem um erro na sintaxe do SQL; verifique o manual que corresponde à versão do seu servidor MySQL para a sintaxe correta a ser usada
1052 Coluna é ambígua ER_NON_UNIQ_ERROR Coluna '%s' em %s é ambígua
1055 A expressão não está no GROUP BY ER_WRONG_FIELD_WITH_GROUP '%s' não está no GROUP BY
1093 Não é possível especificar a tabela de destino para atualização ER_UPDATE_TABLE_USED Não é possível especificar a tabela de destino '%s' para atualização na cláusula FROM
1136 O número de colunas não corresponde ao número de valores ER_WRONG_VALUE_COUNT_ON_ROW O número de colunas não corresponde ao número de valores na linha %ld
1242 Subconsulta retorna mais de 1 linha ER_SUBQUERY_NO_1_ROW Subconsulta retorna mais de 1 linha
1248 Toda tabela derivada deve ter seu próprio alias ER_DERIVED_MUST_HAVE_ALIAS Toda tabela derivada deve ter seu próprio alias
1318 Número incorreto de argumentos ER_SP_WRONG_NO_OF_ARGS Número incorreto de argumentos para %s %s; esperado %u, obtido %u

Bancos de dados, tabelas e colunas

CódigoSignificado
1049 Banco de dados desconhecido ER_BAD_DB_ERROR Banco de dados desconhecido '%s'
1046 Nenhum banco de dados selecionado ER_NO_DB_ERROR Nenhum banco de dados selecionado
1054 Coluna desconhecida na lista de campos ER_BAD_FIELD_ERROR Coluna desconhecida '%s' em '%s'
1146 Tabela não existe ER_NO_SUCH_TABLE Tabela '%s.%s' não existe
1050 Tabela já existe ER_TABLE_EXISTS_ERROR Tabela '%s' já existe
1051 Tabela desconhecida ER_BAD_TABLE_ERROR Tabela desconhecida '%s'
1060 Nome de coluna duplicado ER_DUP_FIELDNAME Nome de coluna duplicado '%s'
1091 Não é possível descartar; verifique se a coluna/chave existe ER_CANT_DROP_FIELD_OR_KEY Não é possível descartar '%s'; verifique se a coluna/chave existe
1305 Função ou procedimento não existe ER_SP_DOES_NOT_EXIST %s %s não existe
1442 O gatilho não pode atualizar sua própria tabela ER_CANT_UPDATE_USED_TABLE_IN_SF_OR_TRG Não é possível atualizar a tabela '%s' dentro de uma função/trigger armazenada porque ela já é usada pela instrução que invocou essa função/trigger armazenada.

Chaves e restrições

CódigoSignificado
1062 Entrada duplicada para chave ER_DUP_ENTRY Entrada duplicada '%s' para a chave %d
1061 Nome de chave duplicado ER_DUP_KEYNAME Nome de chave duplicado '%s'
1452 Falha na chave estrangeira: não é possível adicionar a linha filha ER_NO_REFERENCED_ROW_2 Não é possível adicionar ou atualizar uma linha filha: uma restrição de chave estrangeira falhou%s
1451 Falha na chave estrangeira: não é possível excluir a linha pai ER_ROW_IS_REFERENCED_2 Não é possível excluir ou atualizar a linha pai: uma restrição de chave estrangeira falhou%s
1216 Não é possível adicionar ou atualizar uma linha filha ER_NO_REFERENCED_ROW Não é possível adicionar ou atualizar uma linha filha: uma restrição de chave estrangeira falhou
1217 Não é possível excluir ou atualizar a linha pai ER_ROW_IS_REFERENCED Não é possível excluir ou atualizar a linha pai: uma restrição de chave estrangeira falhou
1215 Não é possível adicionar restrição de chave estrangeira ER_CANNOT_ADD_FOREIGN Não é possível adicionar restrição de chave estrangeira
3780 As colunas da chave estrangeira são incompatíveis ER_FK_INCOMPATIBLE_COLUMNS A coluna de referência '%s' e a coluna referenciada '%s' na restrição de chave estrangeira '%s' são incompatíveis.
1822 Índice ausente para restrição de chave estrangeira ER_FK_NO_INDEX_PARENT Falha ao adicionar a restrição de chave estrangeira. Índice ausente para a restrição '%s' na tabela referenciada '%s'
1824 Falha ao abrir a tabela referenciada ER_FK_CANNOT_OPEN_PARENT Falha ao abrir a tabela referenciada '%s'
1048 Coluna não pode ser nula ER_BAD_NULL_ERROR Coluna '%s' não pode ser nula
3819 Restrição de verificação violada ER_CHECK_CONSTRAINT_VIOLATED Restrição de verificação '%s' violada.
1071 Chave especificada muito longa ER_TOO_LONG_KEY Chave especificada muito longa; o comprimento máximo da chave é %d bytes
1075 Apenas uma coluna automática, e ela deve ser uma chave ER_WRONG_AUTO_KEY Definição de tabela incorreta; só pode haver uma coluna automática e ela deve ser definida como chave
1701 Não é possível truncar uma tabela com chaves estrangeiras ER_TRUNCATE_ILLEGAL_FK Não é possível truncar uma tabela referenciada em uma restrição de chave estrangeira (%s)
1586 Entrada duplicada para chave (com nome da chave) ER_DUP_ENTRY_WITH_KEY_NAME Entrada duplicada '%s' para chave '%s'
1826 Nome de restrição de chave estrangeira duplicado ER_FK_DUP_NAME Nome de restrição de chave estrangeira duplicado '%s'

Valores de dados

CódigoSignificado
1364 O campo não tem valor padrão ER_NO_DEFAULT_FOR_FIELD O campo '%s' não tem valor padrão
1366 Valor incorreto para a coluna ER_TRUNCATED_WRONG_VALUE_FOR_FIELD Valor %s incorreto: '%s' para a coluna '%s' na linha %ld
1406 Dados muito longos para a coluna ER_DATA_TOO_LONG Dados muito longos para a coluna '%s' na linha %ld
1292 Valor incorreto truncado ER_TRUNCATED_WRONG_VALUE Valor %s incorreto truncado: '%s'
1264 Valor fora do intervalo para a coluna ER_WARN_DATA_OUT_OF_RANGE Valor fora do intervalo para a coluna '%s' na linha %ld
1265 Dados truncados para a coluna WARN_DATA_TRUNCATED Dados truncados para a coluna '%s' na linha %ld
1067 Valor padrão inválido ER_INVALID_DEFAULT Valor padrão inválido para '%s'

Transações e bloqueio

CódigoSignificado
1205 Tempo limite de espera por bloqueio excedido ER_LOCK_WAIT_TIMEOUT Tempo limite de espera por bloqueio excedido; tente reiniciar a transação
1213 Deadlock encontrado ao tentar obter o bloqueio ER_LOCK_DEADLOCK Deadlock encontrado ao tentar obter o bloqueio; tente reiniciar a transação
3572 Não foi possível obter o bloqueio com NOWAIT ER_LOCK_NOWAIT Instrução abortada porque o(s) bloqueio(s) não pôde(ram) ser adquirido(s) imediatamente e NOWAIT está definido.
1206 Os bloqueios excedem o tamanho da tabela de bloqueios ER_LOCK_TABLE_FULL O número total de bloqueios excede o tamanho da tabela de bloqueios
1792 Escrita em uma transação READ ONLY ER_CANT_EXECUTE_IN_READ_ONLY_TRANSACTION Não é possível executar a instrução em uma transação READ ONLY.
3024 Tempo máximo de execução da instrução excedido ER_QUERY_TIMEOUT A execução da consulta foi interrompida, tempo máximo de execução da instrução excedido

Limites e configurações do servidor

CódigoSignificado
1040 Muitas conexões ER_CON_COUNT_ERROR Muitas conexões
1203 O usuário tem mais conexões do que max_user_connections ER_TOO_MANY_USER_CONNECTIONS O usuário %s já tem mais conexões ativas do que 'max_user_connections'
1153 Recebeu um pacote maior do que max_allowed_packet ER_NET_PACKET_TOO_LARGE Recebeu um pacote maior do que 'max_allowed_packet' bytes
1175 O modo de atualização segura bloqueou a instrução ER_UPDATE_WITHOUT_KEY_IN_SAFE_MODE Você está usando o modo de atualização segura e tentou atualizar uma tabela sem um WHERE que use uma coluna KEY. %s
1290 A opção do servidor impede esta instrução ER_OPTION_PREVENTS_STATEMENT O servidor MySQL está sendo executado com a opção %s, então não pode executar esta instrução
1114 A tabela está cheia ER_RECORD_FILE_FULL A tabela '%s' está cheia
// um cliente, todos os motores

Uma forma mais rápida de trabalhar com MySQL

O SQLly é um cliente SQL nativo para macOS, Windows e Linux, com IntelliSense baseado no esquema e proteções para instruções arriscadas.