// Referencia de errores de PostgreSQL

PostgreSQL 42601: error de sintaxis en o cerca de

PostgreSQL no pudo analizar la instrucción. El token que menciona y el caret debajo marcan dónde falló el análisis; el error real suele estar justo antes de él.

SQLSTATE
42601
Nombre
syntax_error
Categoría
Error de sintaxis o violación de regla de acceso
Mensaje de error
syntax error at or near "FROM"
LINE 1: SELECT id, name, FROM users;
                         ^

Qué significa

El analizador leyó la instrucción hasta el token del mensaje y encontró algo que no puede ir después. syntax error at end of input significa que la instrucción se detuvo donde se esperaba más, como un paréntesis de cierre faltante.

La posición es donde PostgreSQL notó el problema, que suele estar un token después del error real: una coma final antes de FROM, una coma que falta entre columnas o una palabra reservada usada como nombre.

Causas comunes

  • Una coma final antes de FROM, ) o WHERE, o una coma que falta entre elementos.
  • Una palabra reservada usada como nombre de columna o tabla sin comillas, como user, order o group.
  • Sintaxis de otra base de datos: TOP, [brackets], acentos graves, LIMIT x, y, IFNULL.
  • Paréntesis o comillas sin cerrar, lo que se muestra como un error al final de la entrada.
  • Marcadores de posición del lado del cliente (?, :name, %s) enviados al servidor sin que el controlador los sustituya; el propio PostgreSQL usa $1, $2.

Cómo solucionarlo

  1. Mira el token mencionado en el mensaje y el justo antes de él; elimina la coma de más o añade la que falta.

    SELECT id, name FROM users;
  2. Pon entre comillas las palabras reservadas usadas como identificadores, o cámbiales el nombre.

    SELECT "user", "order" FROM audit_log;
  3. Reescribe la sintaxis de otros dialectos en la forma de PostgreSQL.

    -- SQL Server: SELECT TOP 10 * FROM [orders]
    SELECT * FROM orders LIMIT 10;
    -- MySQL: LIMIT 20, 10
    SELECT * FROM orders LIMIT 10 OFFSET 20;
  4. Para cuerpos PL/pgSQL, usa comillas de dólar para que las comillas dentro del cuerpo no terminen la cadena.

    CREATE FUNCTION greet(name text) RETURNS text
    LANGUAGE plpgsql AS $$
    BEGIN
        RETURN 'Hello, ' || name;
    END;
    $$;

Reprodúcelo de forma segura

SELECT id, FROM (VALUES (1)) v(id);  -- ERROR: syntax error at or near "FROM"

Errores relacionados

Más errores de sintaxis o de violación de reglas de acceso

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

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

Trabajar con PostgreSQL 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 PostgreSQL y las demás bases de datos que uses.