// справочник ошибок PostgreSQL

PostgreSQL 42883: функция не существует

Нет функции или оператора с таким именем и такими типами аргументов. Обычно причина — отсутствие приведения типов, неустановленное расширение или функция в другой схеме.

SQLSTATE
42883
Имя
undefined_function
Категория
Ошибка синтаксиса или нарушение правила доступа
Сообщение об ошибке
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.

Что это значит

PostgreSQL выбирает функцию по её имени и типам аргументов. 42883 означает, что ни одна функция на search_path принимает переданные вами типы, даже с неявным приведением типов. Тот же код покрывает операторы, как в operator does not exist: integer = text.

Начиная с PostgreSQL 8.3 большинство типов больше не приводятся к тексту неявно, поэтому код, написанный для старых версий или для других баз данных, часто натыкается на эту ошибку.

Распространённые причины

  • Типы аргументов не совпадают: целое число передаётся в текстовую функцию или сравнивается integer = text.
  • Вызов функции из расширения, которое не установлено в этой базе данных (uuid_generate_v4(), crypt(), similarity()).
  • Функция лежит в схеме, которой нет в search_path.
  • Вызов функции из другой базы данных, например MySQL IFNULL или DATE_FORMAT.
  • Параметры неизвестного типа от драйвера: привязанный $1 тип которого PostgreSQL не может определить.

Как исправить

  1. Приведите аргумент к типу, который ожидает функция.

    SELECT lower(42::text);
    SELECT * FROM orders WHERE id = '42'::int;
  2. Установите в этой базе данных расширение, предоставляющее эту функцию.

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    SELECT gen_random_uuid();  -- built in since PostgreSQL 13
  3. Найдите функцию и типы её аргументов, затем вызывайте её с указанием схемы.

    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. Замените функции других баз данных на функции PostgreSQL: IFNULL становится COALESCE, DATE_FORMAT становится to_char, NOW() работает как есть.

Безопасное воспроизведение

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

Связанные ошибки

Больше ошибок синтаксиса или нарушения правил доступа

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.