// Referencia de errores de PostgreSQL

PostgreSQL 42883: la función no existe

Ninguna función u operador coincide con ese nombre y esos tipos de argumentos. Suele deberse a que falta un cast, una extensión, o a que la función está en otro esquema.

SQLSTATE
42883
Nombre
undefined_function
Categoría
Error de sintaxis o violación de regla de acceso
Mensaje de error
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.

Qué significa

PostgreSQL elige una función por su nombre y los tipos de sus argumentos. 42883 significa que no hay ninguna función en search_path acepta los tipos que pasaste, incluso con conversiones implícitas. El mismo código cubre los operadores, como en operator does not exist: integer = text.

Desde PostgreSQL 8.3, la mayoría de los tipos ya no se convierten a texto implícitamente, así que el código escrito para versiones anteriores o para otras bases de datos a menudo se topa con esto.

Causas comunes

  • Los tipos de los argumentos no coinciden: pasar un entero a una función de texto, o comparar integer = text.
  • Llamar a una función de una extensión que no está instalada en esta base de datos (uuid_generate_v4(), crypt(), similarity()).
  • La función se encuentra en un esquema que no está en el search_path.
  • Llamar a una función de otra base de datos, como la de MySQL IFNULL o DATE_FORMAT.
  • Parámetros de tipo desconocido de un controlador: un valor enlazado $1 cuyo tipo PostgreSQL no puede inferir.

Cómo solucionarlo

  1. Convierte el argumento al tipo que espera la función.

    SELECT lower(42::text);
    SELECT * FROM orders WHERE id = '42'::int;
  2. Instala en esta base de datos la extensión que proporciona la función.

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    SELECT gen_random_uuid();  -- built in since PostgreSQL 13
  3. Encuentra la función y los tipos de sus argumentos, y luego llámala con el nombre de esquema completo.

    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. Reemplaza las funciones de otras bases de datos por las de PostgreSQL: IFNULL se convierte en COALESCE, DATE_FORMAT se convierte en to_char, NOW() funciona tal cual.

Reprodúcelo de forma segura

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

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.