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

PostgreSQL P0001: вызвано исключение

PL/pgSQL RAISE EXCEPTION без собственного SQLSTATE. Сообщение — это любой текст, который написал автор функции или триггера.

SQLSTATE
P0001
Имя
raise_exception
Категория
Ошибка PL/pgSQL
Сообщение об ошибке
insufficient funds for account 42

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

P0001 (raise_exception) является кодом по умолчанию для RAISE EXCEPTION 'message' в PL/pgSQL. Как таковая это не ошибка PostgreSQL: функция, процедура или триггер в вашей базе сами решили завершиться ошибкой, и текст сообщения приходит из их кода. CONTEXT строки показывают, какая функция и строка вызвали это.

Авторы функций могут указать конкретный SQLSTATE с USING ERRCODE, плюс DETAIL и HINT, что облегчает обработку ошибки для приложений.

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

  • Бизнес-правило, реализованное в триггере или функции, например проверка баланса, отклонило изменение.
  • Функция проверки, вызываемая приложением, вернула ошибку для некорректных входных данных.
  • Вот ASSERT при сбое возвращает другой код, P0004 (assert_failure).

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

  1. Прочтите CONTEXT строки, чтобы найти функцию и строку, затем посмотрите на её исходный код.

    SELECT pg_get_functiondef('debit_account'::regproc);
  2. Исправьте данные или вызов, чтобы правило было выполнено, или измените правило, если оно неверное.

  3. При написании таких проверок давайте им осмысленный код и описание, чтобы вызывающий код мог их различать.

    RAISE EXCEPTION 'insufficient funds for account %', p_account
        USING ERRCODE = 'check_violation',
              DETAIL = format('balance %s, requested %s', v_balance, p_amount);

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

DO $$ BEGIN RAISE EXCEPTION 'something went wrong'; END $$;  -- ERROR: something went wrong (SQLSTATE P0001)

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

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

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

Работа с PostgreSQL в SQLly

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