// справочник ошибок PostgreSQL

PostgreSQL 42P02: параметр отсутствует

В SQL есть заполнитель вида $1, но ему не привязано значение параметра — чаще всего из-за прямого выполнения драйверного SQL или заполнителей внутри кавычек.

SQLSTATE
42P02
Имя
undefined_parameter
Категория
Ошибка синтаксиса или нарушение правила доступа
Сообщение об ошибке
there is no parameter $1

Что это значит

Собственные заполнители PostgreSQL: $1, $2 и так далее, они заполняются при подготовке или выполнении запроса с привязанными параметрами. Если текст содержит $1 но запрос был отправлен без параметров, PostgreSQL нечего подставлять, и он завершается ошибкой 42P02 (undefined_parameter).

Это обычно означает, что SQL, скопированный из кода приложения или лога, был выполнен вручную, или драйвер отправил строку запроса с заполнителями через путь, который их не подставляет.

Распространённые причины

  • Выполнение параметризованного запроса, скопированного из кода или лога, в psql или SQL-редакторе.
  • Заполнители внутри строки или тела функции в долларных кавычках, где драйвер их не подставляет.
  • A DO блок или динамический SQL, использующий $1 без EXECUTE ... USING.
  • Смешивание стилей заполнителей драйвера: ? или %s в одном месте, $1 в другом.

Как исправить

  1. При выполнении вручную замените заполнители конкретными значениями или используйте PREPARE и EXECUTE.

    PREPARE find_order(int) AS SELECT * FROM orders WHERE id = $1;
    EXECUTE find_order(42);
  2. В динамическом SQL внутри PL/pgSQL передавайте значения с USING.

    DO $$
    DECLARE n int;
    BEGIN
        EXECUTE 'SELECT count(*) FROM orders WHERE customer_id = $1' INTO n USING 42;
        RAISE NOTICE '%', n;
    END;
    $$;
  3. В коде приложения передавайте значения через API параметров драйвера, а не склеивайте их в строку.

Безопасное воспроизведение

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

Связанные ошибки

Больше ошибок синтаксиса или нарушения правил доступа

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.