// Référence des erreurs PostgreSQL

PostgreSQL 42883 : la fonction n'existe pas

Aucune fonction ou opérateur ne correspond à ce nom avec ces types d'arguments. En général, un cast manquant, une extension manquante ou une fonction dans un autre schéma.

SQLSTATE
42883
Nom
undefined_function
Catégorie
Erreur de syntaxe ou violation de règle d'accès
Message d'erreur
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.

Ce que cela signifie

PostgreSQL choisit une fonction par son nom et les types de ses arguments. 42883 signifie qu'aucune fonction du search_path accepte les types que vous avez passés, même avec des casts implicites. Le même code couvre les opérateurs, comme dans operator does not exist: integer = text.

Depuis PostgreSQL 8.3, la plupart des types ne sont plus convertis implicitement en texte, donc le code écrit pour les versions plus anciennes ou pour d'autres bases de données rencontre souvent ce problème.

Causes courantes

  • Les types d'arguments ne correspondent pas : passer un entier à une fonction de texte, ou comparer integer = text.
  • Appeler une fonction d'une extension qui n'est pas installée dans cette base de données (uuid_generate_v4(), crypt(), similarity()).
  • La fonction se trouve dans un schéma qui n’est pas dans le search_path.
  • Appeler une fonction depuis une autre base de données, comme MySQL IFNULL ou DATE_FORMAT.
  • Paramètres de type inconnu provenant d’un pilote : un paramètre lié $1 dont PostgreSQL ne peut pas déduire le type.

Comment le corriger

  1. Convertissez l’argument vers le type attendu par la fonction.

    SELECT lower(42::text);
    SELECT * FROM orders WHERE id = '42'::int;
  2. Installez l'extension qui fournit la fonction, dans cette base de données.

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    SELECT gen_random_uuid();  -- built in since PostgreSQL 13
  3. Trouvez la fonction et ses types d'arguments, puis appelez-la avec le schéma qualifié.

    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. Remplacez les fonctions des autres bases de données par celles de PostgreSQL : IFNULL devient COALESCE, DATE_FORMAT devient to_char, NOW() fonctionne tel quel.

Reproduisez-le en toute sécurité

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

Erreurs liées

Plus d'erreurs de syntaxe ou de violation de règle d'accès

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.