// Referência de erro do PostgreSQL

PostgreSQL 42883: função não existe

Nenhuma função ou operador corresponde a esse nome com esses tipos de argumento. Geralmente, é um cast ausente, uma extensão ausente ou uma função em outro esquema.

SQLSTATE
42883
Nome
undefined_function
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
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.

O que significa

O PostgreSQL escolhe uma função pelo seu nome e pelos tipos de seus argumentos. 42883 significa que não há função na search_path aceita os tipos que você passou, mesmo com conversões implícitas. O mesmo código cobre operadores, como em operator does not exist: integer = text.

Desde o PostgreSQL 8.3, a maioria dos tipos não é mais convertida implicitamente para texto, então códigos escritos para versões antigas ou para outros bancos de dados frequentemente encontram isso.

Causas comuns

  • Os tipos de argumento não correspondem: passando um inteiro para uma função de texto ou comparando integer = text.
  • Chamar uma função de uma extensão que não está instalada neste banco de dados (uuid_generate_v4(), crypt(), similarity()).
  • A função está em um esquema que não está no search_path.
  • Chamar uma função de outro banco de dados, como a do MySQL IFNULL ou DATE_FORMAT.
  • Parâmetros de tipo desconhecido de um driver: um valor vinculado $1 cujo tipo o PostgreSQL não consegue inferir.

Como corrigir

  1. Converta o argumento para o tipo que a função espera.

    SELECT lower(42::text);
    SELECT * FROM orders WHERE id = '42'::int;
  2. Instale a extensão que fornece a função, neste banco de dados.

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    SELECT gen_random_uuid();  -- built in since PostgreSQL 13
  3. Encontre a função e os tipos dos argumentos e chame-a com o nome qualificado pelo esquema.

    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. Substitua as funções de outros bancos de dados pelas do PostgreSQL: IFNULL se torna COALESCE, DATE_FORMAT se torna to_char, NOW() funciona como está.

Reproduza com segurança

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

Erros relacionados

Mais erros de sintaxe ou violação de regra de acesso

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.