// Referencia de errores de PostgreSQL

PostgreSQL 42P02: no hay parámetro

El SQL contiene un marcador estilo $1, pero no se vinculó ningún valor de parámetro; suele ocurrir al ejecutar directamente SQL del controlador o con marcadores dentro de comillas.

SQLSTATE
42P02
Nombre
undefined_parameter
Categoría
Error de sintaxis o violación de regla de acceso
Mensaje de error
there is no parameter $1

Qué significa

Los propios marcadores de posición de PostgreSQL son $1, $2 y así sucesivamente, se rellenan cuando una instrucción se prepara o se ejecuta con parámetros vinculados. Si el texto contiene $1 pero la instrucción se envió sin parámetros, PostgreSQL no tiene nada que sustituir y falla con 42P02 (undefined_parameter).

Esto suele significar que se ejecutó a mano un SQL copiado del código de la aplicación o de un registro, o que un controlador envió una consulta con marcadores de posición por una ruta que no los enlaza.

Causas comunes

  • Ejecutando una consulta parametrizada copiada del código o de registros en psql o un editor de SQL.
  • Marcadores de posición dentro de una cadena o del cuerpo de una función entre dólar, donde el controlador no los sustituye.
  • A DO bloque o SQL dinámico que use $1 sin EXECUTE ... USING.
  • Mezclar estilos de marcadores de posición del controlador: ? o %s en un solo lugar, $1 en otra.

Cómo solucionarlo

  1. Cuando lo ejecutes a mano, reemplaza los marcadores de posición con valores literales, o usa PREPARE y EXECUTE.

    PREPARE find_order(int) AS SELECT * FROM orders WHERE id = $1;
    EXECUTE find_order(42);
  2. En SQL dinámico dentro de PL/pgSQL, pasa los valores con USING.

    DO $$
    DECLARE n int;
    BEGIN
        EXECUTE 'SELECT count(*) FROM orders WHERE customer_id = $1' INTO n USING 42;
        RAISE NOTICE '%', n;
    END;
    $$;
  3. En el código de la aplicación, pasa los valores a través de la API de parámetros del controlador en lugar de concatenarlos.

Reprodúcelo de forma segura

SELECT $1;  -- ERROR: there is no parameter $1

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.