BD2 · S3 · Manejo de excepciones y robustez¶
SGE-JD · JD Refrigeración S.A.C. · Equipo CherryTree · Yoel Wagner Chambi Sirena · 10/11/2026
Trabajo autónomo de la sesión 3: excepciones predefinidas y personalizadas, más un registro de errores, sobre
el motor transaccional de la venta de S1. Se ejecutó en la base de práctica sge-jd-bd2,
después de S1 y S2.
| Orden | Script | Qué hace |
|---|---|---|
| 1 | S03_01_log_errores.sql | Tabla LOG_ERRORES (sin FK) y SP_REGISTRAR_ERROR (transacción autónoma) |
| 2 | S03_02_hallazgo_rollback.sql | Demuestra por qué el registro necesita su propia transacción |
| 3 | S03_03_plsql.sql | SP_REGISTRAR_VENTA y FN_TOTAL_VENTA, versión 2, con excepciones |
| 4 | S03_04_pruebas.sql | Caso válido y uno por cada excepción; consulta del registro |
| 5 | S03_05_bloqueo.ps1 (+ S03_05a, S03_05b) |
Fila ocupada: dos sesiones a la vez |
1. Errores reales que S1 no manejaba¶
| # | Error | Qué pasaba en S1 | Ahora |
|---|---|---|---|
| 1 | Otra transacción tiene el producto bloqueado (el backend vendiéndolo) | FOR UPDATE sin límite: el procedimiento esperaba para siempre |
FOR UPDATE WAIT 10, igual que VentaRepository.bloquear() en Java (10 s); responde ORA-20017 |
| 2 | Nombre del vendedor de más de 60 caracteres | ORA-12899 crudo, con el nombre interno de la tabla y la columna | Excepción con nombre (PRAGMA EXCEPTION_INIT(-12899)) → ORA-20018 con un mensaje claro |
| 3 | Cliente inexistente | Se contaba con COUNT(*) y se lanzaba ORA-20010, sin registro |
SELECT INTO con NO_DATA_FOUND, en su propio bloque |
| 4 | Un solo WHEN NO_DATA_FOUND al final de todo |
Cualquier NO_DATA_FOUND, viniera de donde viniera, se informaba como "el producto no existe" |
Cada SELECT INTO tiene su bloque y su mensaje |
| 5 | Ningún error quedaba registrado | Si Lucy decía "no me deja vender", no había forma de saber por qué | Todo error se registra en LOG_ERRORES antes de relanzarse |
2. Tabla de registro de errores¶
CREATE TABLE log_errores (
id_log NUMBER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
objeto VARCHAR2(60) NOT NULL, -- procedimiento o función donde ocurrió
codigo_error NUMBER NOT NULL, -- SQLCODE: 100 (NO_DATA_FOUND), -1, -20xxx…
mensaje_error VARCHAR2(500),
contexto VARCHAR2(500), -- parámetros con los que se llamó
traza VARCHAR2(1000), -- DBMS_UTILITY.FORMAT_ERROR_BACKTRACE: en qué línea
fecha_evento TIMESTAMP DEFAULT SYSTIMESTAMP NOT NULL,
usuario_oracle VARCHAR2(128) DEFAULT USER NOT NULL,
programa VARCHAR2(64)
);
No tiene ninguna FOREIGN KEY, porque el error de un cliente inexistente no podría registrarse si
contexto apuntara a CLIENTES. Respecto de la tabla de la guía, agrega dos columnas:
contexto: los parámetros de la llamada, para reproducir el error.traza: la línea exacta del código donde ocurrió.
La escribe un solo procedimiento con transacción autónoma:
CREATE OR REPLACE PROCEDURE sp_registrar_error(p_objeto IN VARCHAR2, p_codigo IN NUMBER,
p_mensaje IN VARCHAR2, p_contexto IN VARCHAR2 DEFAULT NULL) IS
PRAGMA AUTONOMOUS_TRANSACTION;
BEGIN
INSERT INTO log_errores (objeto, codigo_error, mensaje_error, contexto, traza, programa)
VALUES (SUBSTR(p_objeto, 1, 60), p_codigo, SUBSTR(p_mensaje, 1, 500), SUBSTR(p_contexto, 1, 500),
SUBSTR(DBMS_UTILITY.FORMAT_ERROR_BACKTRACE, 1, 1000), SUBSTR(SYS_CONTEXT('USERENV', 'MODULE'), 1, 64));
COMMIT; -- confirma SOLO esta fila; no toca la transacción de quien llama
END;
Por qué hace falta la transacción autónoma: es el hallazgo principal de la sesión (sección 6).
3. Excepciones incorporadas¶
| Tipo | Excepción | Dónde | Cuándo ocurre de verdad | Código que devuelve |
|---|---|---|---|---|
| Predefinida | NO_DATA_FOUND |
SELECT id INTO v_cliente FROM clientes … |
Lucy elige un cliente que otra persona acaba de borrar, o un script manda un ID equivocado | ORA-20010 (SQLCODE registrado: 100) |
| Predefinida | NO_DATA_FOUND |
SELECT … FROM productos … FOR UPDATE WAIT 10 |
Producto inexistente | ORA-20015 (registrado: 100) |
Personalizada, PRAGMA EXCEPTION_INIT |
e_fila_ocupada (-54) y e_fila_ocupada_19c (-30006) |
El mismo SELECT … FOR UPDATE WAIT 10 |
Otra venta o compra del mismo producto está en curso | ORA-20017 |
Personalizada, PRAGMA EXCEPTION_INIT |
e_valor_largo (-12899) |
INSERT INTO ventas |
El nombre del vendedor pasa de 60 caracteres | ORA-20018 |
Personalizada, RAISE_APPLICATION_ERROR |
Reglas de negocio | Procedimiento local fallar() |
Descuento sobre el tope (-20012), cantidad ≤ 0 (-20016), stock (-20013), moneda (-20011), más de 700 soles (-20014) | El mismo código |
| Red de seguridad | WHEN OTHERS |
Final del procedimiento | Cualquier error no previsto | Se registra y se relanza con RAISE (nunca THEN NULL) |
Cuál de las dos formas de excepción personalizada se usa depende de quién genera el error:
PRAGMA EXCEPTION_INITsirve cuando el error lo genera Oracle (ORA-00054, ORA-12899) y se le quiere dar un nombre para atraparlo solo a él.RAISE_APPLICATION_ERRORsirve cuando el error no existe en Oracle. Que un descuento de 25 % supere el tope de Lucy solo lo sabe la regla de JD, así que el código lo crea el procedimiento.
El orden en todos los casos es: primero registrar, después relanzar. Si se relanza primero, la ejecución sale del bloque y la línea del registro nunca corre.
4. Evidencia de ejecución¶
Compilación: Procedure created. No errors. Las cuatro piezas (SP_REGISTRAR_VENTA,
FN_TOTAL_VENTA, SP_REGISTRAR_ERROR, FN_SUBTOTAL_LINEA) quedan VALID.
Caso válido y casos inválidos. Cada uno se llama como lo haría el backend, con ROLLBACK al recibir el error:
Venta 1025 registrada, total 15.69
1 NO_DATA_FOUND (cliente): ORA-20010: El cliente -1 no existe.
2 NO_DATA_FOUND (producto): ORA-20015: El producto -1 no existe.
3 personalizada (tope): ORA-20012: El descuento de 25 % supera el tope de 10 %.
4 personalizada (cantidad 0): ORA-20016: La cantidad debe ser mayor que cero.
5 EXCEPTION_INIT ORA-12899: ORA-20018: Un dato es demasiado largo (el nombre del vendedor admite 60 caracteres).
SELECT fn_total_venta(-1) FROM dual
ORA-20004: La venta -1 no existe o no tiene líneas.
Fila ocupada, con dos sesiones (S03_05_bloqueo.ps1). La sesión A bloquea el producto 27 durante 20 s; la
sesión B intenta venderlo:
Sesion A: producto bloqueado a las 19:04:01
Sesion B: intenta vender el producto 27 a las 19:04:05
Sesion B: ORA-20017: El producto 27 está siendo usado por otra venta o compra. Intente de nuevo en unos segundos.
Sesion B: respondió a las 19:04:15 (esperó 10 s)
Sesion A: libera el producto a las 19:04:21
Registro de errores. El caso válido no aparece, y cada error quedó registrado aunque quien llamaba hizo ROLLBACK:
OBJETO CODIGO MENSAJE CONTEXTO
SP_REGISTRAR_VENTA 100 Cliente no encontrado: -1 cliente=-1 producto=27 cantidad=1 descuento=0 rol=ASISTENTE
SP_REGISTRAR_VENTA 100 Producto no encontrado: -1 cliente=1 producto=-1 cantidad=1 descuento=0 rol=ASISTENTE
SP_REGISTRAR_VENTA -20012 El descuento de 25 % supera el tope de 10 %. cliente=1 producto=27 cantidad=1 descuento=25 rol=ASISTENTE
SP_REGISTRAR_VENTA -20016 La cantidad debe ser mayor que cero. cliente=1 producto=27 cantidad=0 descuento=0 rol=ASISTENTE
SP_REGISTRAR_VENTA -12899 ORA-12899: value too large for column "JDREFRIGERACION"."VENTAS"."VENDEDOR_NOMBRE" (actual: 80, maximum: 60)
FN_TOTAL_VENTA -20004 Venta sin líneas o inexistente venta=-1
SP_REGISTRAR_VENTA -54 ORA-00054: Failed to acquire a lock … ORA-40097: Failure to acquire row lock … cliente=1 producto=27 …
ID_LOG TRAZA (FORMAT_ERROR_BACKTRACE)
16 ORA-06512: at "JDREFRIGERACION.SP_REGISTRAR_VENTA", line 42 ← SELECT del cliente
17 ORA-06512: at "JDREFRIGERACION.SP_REGISTRAR_VENTA", line 51 ← SELECT del producto
20 ORA-06512: at "JDREFRIGERACION.SP_REGISTRAR_VENTA", line 96 ← INSERT INTO ventas
El registro guarda el SQLCODE original y la respuesta al usuario lleva un código propio:
NO_DATA_FOUNDse registra con 100, el único código positivo, que significa "no hay filas".- ORA-12899 se registra con -12899.
- Las reglas propias se registran con -200xx, el rango que Oracle reserva para
RAISE_APPLICATION_ERROR.
Las reglas propias (filas 18, 19 y 21) no tienen traza porque se registran antes de que exista una excepción.
Regresión. Con la versión 2 se volvieron a correr las pruebas de S1 y S2, sin cambios en los resultados: 237/237 totales iguales a Java, los rechazos de S1, la CHECK de stock y los tres rechazos del trigger de S2.
5. Relación con ADS y LP2¶
| Objeto BD2 | Decisión ADS | LP2 |
|---|---|---|
SP_REGISTRAR_ERROR + LOG_ERRORES |
Auditabilidad y diagnóstico (atributo 3, ADS S1) | Complementa los logs de logback-spring.xml: Oracle registra lo que pasa adentro de la base, el log de Java la petición completa |
FOR UPDATE WAIT 10 y ORA-20017 |
Integridad con concurrencia (atributo 1) | El mismo límite que VentaRepository.bloquear() (jakarta.persistence.lock.timeout = 10000) |
| ORA-200xx con mensaje claro | Usabilidad: Lucy entiende qué pasó | GlobalExceptionHandler traduce a 400/404/409 las reglas de Java; las de Oracle se verán al integrar |
6. Error o hallazgo¶
Hallazgo 1: el registro de errores de la guía se pierde. El patrón de la guía es
INSERT INTO log_errores … seguido de RAISE_APPLICATION_ERROR. Se probó tal cual (S03_02):
A) INSERT directo y luego RAISE → QUEDARON_SIN_AUTONOMA = 0
B) SP_REGISTRAR_ERROR (autónoma) y luego RAISE → QUEDARON_CON_AUTONOMA = 1
C) Quien llama hace ROLLBACK (como Spring) → solo queda PRUEBA_ROLLBACK_CON (1 fila)
Cuando una excepción sale de un bloque PL/SQL hacia el cliente, Oracle deshace todo lo que hizo esa
llamada, porque la sentencia es atómica, y eso incluye el INSERT del registro. Y si el cliente es el backend,
Spring hace ROLLBACK de la transacción al recibir la excepción. En los dos casos, el registro desaparece
justo cuando más se necesita. Corrección: el registro lo hace SP_REGISTRAR_ERROR con
PRAGMA AUTONOMOUS_TRANSACTION, que confirma solo su propia fila. Se usa únicamente para el registro, nunca
para datos del negocio: una venta en transacción autónoma podría quedar confirmada a medias.
Hallazgo 2: Oracle 23 no da el error que esperaba. La primera versión capturaba ORA-30006, que es lo que
documentan las versiones anteriores para un FOR UPDATE WAIT vencido. Con dos sesiones reales, Oracle 23
respondió ORA-00054 (Failed to acquire a lock … ORA-40097). La excepción con nombre no lo atrapó. Lo
salvó el WHEN OTHERS final, que registró y relanzó, y por eso el error quedó en LOG_ERRORES con código
-54 y se pudo diagnosticar. Si ese WHEN OTHERS hubiera sido THEN NULL, la venta habría "fallado sin
error". Corrección: se nombran las dos (-54 y -30006), y la prueba repetida responde ORA-20017 a los 10 s.
7. Reflexión¶
¿Por qué capturar un error y no volver a lanzarlo puede ser peor que no manejarlo?
Un error sin manejar, al menos, se ve: el backend recibe la excepción, deshace la transacción y Lucy ve un
mensaje. Un error capturado y no relanzado (WHEN OTHERS THEN NULL) desaparece. El procedimiento termina
"bien", quien llama confirma, y queda una venta a medias o ninguna venta, sin que nadie lo sepa. En SGE-JD eso
significaría una factura enviada a SUNAT sin su venta, o un stock descontado sin venta registrada, y se
descubriría semanas después, al cuadrar el inventario. El hallazgo 2 lo mostró en pequeño: el error que mi
código no esperaba (ORA-00054) se diagnosticó solo porque el WHEN OTHERS lo registró y lo relanzó.
Registrar es para entender. Relanzar es para que el sistema no siga como si nada hubiera pasado.