// Referência de erro do MySQL

Erro do MySQL 1064: Você tem um erro na sua sintaxe SQL

O MySQL não conseguiu analisar a instrução. O texto após near mostra onde a análise parou; o erro geralmente está exatamente ali ou logo antes.

Número do erro
1064
Nome
ER_PARSE_ERROR
SQLSTATE
42000
Categoria
Sintaxe e instruções
Mensagem de erro
%s near '%s' at line %d

O que significa

1064 é o erro de parse. A mensagem de referência segue o formato %s near '%s' at line %d, onde a primeira parte é o texto genérico You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use, a parte entre aspas é o SQL a partir do ponto em que o analisador desistiu, e a numeração de linhas conta desde o início da instrução.

O analisador para no primeiro token que não consegue encaixar, então o erro real geralmente está no token logo antes do texto entre aspas: uma vírgula faltando, uma aspa não fechada ou uma palavra reservada usada como nome.

Causas comuns

  • Uma palavra reservada usada como nome de tabela ou coluna sem crases, como order, group, key ou rank (reservada desde a versão 8.0).
  • Uma vírgula, um parêntese ou uma aspa ausente ou sobrando.
  • Sintaxe de outro banco de dados: TOP, [brackets], ISNULL() do SQL Server, ou :: casts e RETURNING do PostgreSQL.
  • Sintaxe mais recente do que o servidor, como funções de janela ou CTEs no MySQL 5.7.
  • Um script com DELIMITER ou corpos de rotinas armazenadas enviados por um driver que não entende DELIMITER (é um comando do cliente mysql, não SQL).

Como corrigir

  1. Veja o texto entre aspas após near e o token logo antes dele. Se o texto entre aspas estiver vazio (near ''), a instrução terminou cedo demais, muitas vezes devido a aspas ou parêntese não fechados.

  2. Envolva com crases os identificadores que são palavras reservadas.

    SELECT `order`, `rank` FROM `group` WHERE `key` = 1;
  3. Verifique a versão do servidor antes de usar sintaxe mais recente.

    SELECT VERSION();
  4. Reescreva a sintaxe de outros dialetos: LIMIT em vez de TOP, crases em vez de colchetes, CAST(x AS ...) em vez de ::.

Reproduza com segurança

SELECT * FROM orders WHERE id = 1 ORDER date;
-- ERROR 1064 (42000): You have an error in your SQL syntax; ... near 'date' at line 1

Erros relacionados

Mais erros de sintaxe e instruções

O código e o texto da mensagem são de Referência de mensagens de erro do MySQL 8.4. Veja toda a Lista de erros do MySQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com MySQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o MySQL e os outros bancos de dados que você usa.