// Referencia de errores de PostgreSQL

PostgreSQL P0001: excepción lanzada

Un RAISE EXCEPTION de PL/pgSQL sin su propio SQLSTATE. El mensaje es cualquier texto que el autor de la función o del desencadenador haya escrito.

SQLSTATE
P0001
Nombre
raise_exception
Categoría
Error de PL/pgSQL
Mensaje de error
insufficient funds for account 42

Qué significa

P0001 (raise_exception) es el código predeterminado para RAISE EXCEPTION 'message' en PL/pgSQL. No es un error de PostgreSQL en sí: una función, procedimiento o trigger de tu base de datos decidió fallar, y el texto del mensaje viene de su código. Las CONTEXT líneas muestran qué función y línea lo provocaron.

Quien escribe funciones puede indicar un SQLSTATE específico con USING ERRCODE, además de DETAIL y HINT, lo que hace que el error sea más fácil de manejar para las aplicaciones.

Causas comunes

  • Una regla de negocio aplicada en un disparador o función, como una verificación de saldo, rechazó el cambio.
  • Una función de validación llamada por la aplicación generó un error ante datos de entrada incorrectos.
  • Una ASSERT informa un código diferente, P0004 (assert_failure).

Cómo solucionarlo

  1. Lee las CONTEXT líneas para encontrar la función y la línea, luego revisa su código fuente.

    SELECT pg_get_functiondef('debit_account'::regproc);
  2. Corrige los datos o la llamada para que se cumpla la regla, o cambia la regla si está equivocada.

  3. Al escribir tales verificaciones, asígnales un código significativo y un detalle para que los llamadores puedan diferenciarlas.

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

Reprodúcelo de forma segura

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

Errores relacionados

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.