// PostgreSQL-Fehlerreferenz

PostgreSQL 42P02: es gibt keinen Parameter

Das SQL enthält einen Platzhalter im $1-Stil, aber es wurde kein Parameterwert gebunden – oft durch direktes Ausführen von Treiber-SQL oder durch Platzhalter in Anführungszeichen.

SQLSTATE
42P02
Name
undefined_parameter
Kategorie
Syntaxfehler oder Zugriffsregelverletzung
Fehlermeldung
there is no parameter $1

Was es bedeutet

Die eigenen Platzhalter von PostgreSQL sind $1, $2 und so weiter, gefüllt, wenn eine Anweisung vorbereitet oder mit gebundenen Parametern ausgeführt wird. Wenn der Text $1 enthält, aber die Anweisung ohne Parameter gesendet wurde, hat PostgreSQL nichts zum Ersetzen und schlägt mit 42P02 fehl.undefined_parameter).

Das passiert meist, wenn SQL aus Anwendungscode oder einem Log von Hand ausgeführt wurde, oder wenn ein Treiber eine Abfragezeichenfolge mit Platzhaltern über einen Pfad geschickt hat, der sie nicht bindet.

Häufige Ursachen

  • Ausführen einer parametrisierten Abfrage, die aus Code oder Logs in psql oder einem SQL-Editor kopiert wurde.
  • Platzhalter innerhalb eines Strings oder eines dollar-quotierten Funktionskörpers, bei denen der Treiber sie nicht ersetzt.
  • A DO Block oder dynamisches SQL unter Verwendung von $1 ohne EXECUTE ... USING.
  • Vermischte Treiber-Platzhalterstile: ? oder %s an einer Stelle, $1 an einer anderen.

Wie du es behebst

  1. Wenn du es von Hand ausführst, ersetze die Platzhalter durch Literalwerte oder verwende PREPARE und EXECUTE.

    PREPARE find_order(int) AS SELECT * FROM orders WHERE id = $1;
    EXECUTE find_order(42);
  2. In dynamischem SQL innerhalb von PL/pgSQL übergib Werte mit USING.

    DO $$
    DECLARE n int;
    BEGIN
        EXECUTE 'SELECT count(*) FROM orders WHERE customer_id = $1' INTO n USING 42;
        RAISE NOTICE '%', n;
    END;
    $$;
  3. Gib die Werte im Anwendungscode über die Parameter-API des Treibers weiter, statt sie zusammenzustückeln.

Sicher reproduzieren

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

Zugehörige Fehler

Weitere Syntaxfehler oder Verletzungen von Zugriffsregeln

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.