// Referencia de errores de MySQL

Error de MySQL 1064: hay un error en la sintaxis SQL

MySQL no pudo analizar la instrucción. El texto después de «near» muestra dónde se detuvo el análisis; el error suele estar justo ahí o justo antes.

Número de error
1064
Nombre
ER_PARSE_ERROR
SQLSTATE
42000
Categoría
Sintaxis e instrucciones
Mensaje de error
%s near '%s' at line %d

Qué significa

1064 es el error de sintaxis. El mensaje de referencia tiene este formato %s near '%s' at line %d, donde la primera parte es el 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, la parte entre comillas es el SQL desde el punto en que el analizador se dio por vencido, y el número de línea cuenta desde el inicio de la instrucción.

El analizador se detiene en el primer token que no encaja, así que el error real suele estar en el token justo antes del texto entre comillas: una coma que falta, una comilla sin cerrar o una palabra reservada usada como nombre.

Causas comunes

  • Una palabra reservada usada como nombre de tabla o columna sin comillas invertidas, como order, group, key o rank (reservada desde la 8.0).
  • Falta o sobra una coma, un paréntesis o una comilla.
  • Sintaxis de otra base de datos: TOP, [brackets], ISNULL() de SQL Server, o :: conversión de tipos y RETURNING de PostgreSQL.
  • Sintaxis más reciente que la del servidor, como funciones de ventana o CTE en MySQL 5.7.
  • Un script con DELIMITER o cuerpos de programas almacenados enviados a través de un controlador que no entiende DELIMITER (es un comando del cliente mysql, no SQL).

Cómo solucionarlo

  1. Mira el texto entre comillas después de near y el token justo antes de él. Si el texto entre comillas está vacío (near ''), la instrucción terminó antes de tiempo, a menudo por una comilla o un paréntesis sin cerrar.

  2. Pon entre comillas, con backticks, los identificadores que son palabras reservadas.

    SELECT `order`, `rank` FROM `group` WHERE `key` = 1;
  3. Verifica la versión del servidor antes de usar sintaxis más reciente.

    SELECT VERSION();
  4. Reescribe la sintaxis de otros dialectos: LIMIT en lugar de TOP, acentos graves en lugar de corchetes, CAST(x AS ...) en lugar de ::.

Reprodúcelo de forma segura

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

Errores relacionados

Más errores de sintaxis e instrucciones

El código y el texto del mensaje son de Referencia de mensajes de error de MySQL 8.4. Explora la lista completa de Lista de errores de MySQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con MySQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para MySQL y las demás bases de datos que uses.