// PostgreSQL-Fehlerreferenz

PostgreSQL 42883: Funktion existiert nicht

Zu diesem Namen mit diesen Argumenttypen passt keine Funktion und kein Operator. Meistens fehlt ein Cast oder eine Erweiterung, oder die Funktion liegt in einem anderen Schema.

SQLSTATE
42883
Name
undefined_function
Kategorie
Syntaxfehler oder Zugriffsregelverletzung
Fehlermeldung
function lower(integer) does not exist
LINE 1: SELECT lower(42);
               ^
HINT:  No function matches the given name and argument types. You might need to add explicit type casts.

Was es bedeutet

PostgreSQL wählt eine Funktion nach ihrem Namen und den Typen ihrer Argumente aus. 42883 bedeutet, dass keine Funktion search_path die Typen akzeptiert, die du übergibst, auch mit impliziten Casts. Derselbe Code gilt für Operatoren, wie in operator does not exist: integer = text.

Seit PostgreSQL 8.3 werden die meisten Typen nicht mehr implizit in Text umgewandelt, sodass Code, der für ältere Versionen oder für andere Datenbanken geschrieben wurde, oft auf dieses Problem stößt.

Häufige Ursachen

  • Die Argumenttypen passen nicht zusammen: ein Integer, der an eine Textfunktion übergeben wird, oder ein Vergleich von integer = text.
  • Aufrufen einer Funktion aus einer Erweiterung, die in dieser Datenbank nicht installiert ist (uuid_generate_v4(), crypt(), similarity()).
  • Die Funktion befindet sich in einem Schema, das nicht auf dem search_path.
  • Aufrufen einer Funktion aus einer anderen Datenbank, etwa der von MySQL IFNULL oder DATE_FORMAT.
  • Parameter mit unbekanntem Typ von einem Treiber: ein gebundener $1 dessen Typ PostgreSQL nicht ableiten kann.

Wie du es behebst

  1. Den Argumenttyp in den Typ umwandeln, den die Funktion erwartet.

    SELECT lower(42::text);
    SELECT * FROM orders WHERE id = '42'::int;
  2. Installiere in dieser Datenbank die Erweiterung, die die Funktion bereitstellt.

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    SELECT gen_random_uuid();  -- built in since PostgreSQL 13
  3. Finde die Funktion und ihre Argumenttypen, und rufe sie dann schema-qualifiziert auf.

    SELECT n.nspname, p.proname, pg_get_function_identity_arguments(p.oid)
    FROM pg_proc p JOIN pg_namespace n ON n.oid = p.pronamespace
    WHERE p.proname = 'my_func';
  4. Ersetze Funktionen anderer Datenbanken durch PostgreSQL-Funktionen: IFNULL wird COALESCE, DATE_FORMAT wird to_char, NOW() funktioniert unverändert.

Sicher reproduzieren

SELECT lower(42);  -- ERROR: function lower(integer) does not exist

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.