Fundamentos de Transacciones

9 ejemplos para empezar con transacciones de PostgreSQL: 6 básicos y 3 intermedios.

Prerrequisitos

Tablas de ejemplo con claves foráneas para observar el comportamiento de rollback.

# Desarrollo local con Docker (PostgreSQL 18)
docker run -d --name pg18 -e POSTGRES_PASSWORD=dev -p 5432:5432 postgres:18
psql postgres://postgres:dev@localhost:5432/postgres

Ejemplos Básicos

1. Transacción Explícita

BEGIN inicia un bloque; COMMIT lo hace duradero.

BEGIN;
UPDATE app.accounts SET name = 'Acme Corp' WHERE id = 1;
COMMIT;

• Todas las sentencias en el bloque comparten una única instantánea
• COMMIT vacía el WAL según synchronous_commit
• Las aplicaciones cliente deben usar las APIs de pool de conexiones para transacciones

2. Rollback ante Fallo

ROLLBACK descarta el trabajo no confirmado.

BEGIN;
UPDATE app.accounts SET name = 'Bad' WHERE id = 1;
ROLLBACK;
SELECT name FROM app.accounts WHERE id = 1;

• Usa try/catch en la aplicación para hacer ROLLBACK
• Savepoint para deshacer parcial
• No dejes transacciones fallidas abiertas

3. Savepoint

Punto de rollback anidado.

BEGIN;
INSERT INTO app.accounts (name) VALUES ('Temp');
SAVEPOINT sp1;
UPDATE app.accounts SET name = 'Oops' WHERE name = 'Temp';
ROLLBACK TO sp1;
COMMIT;

• RELEASE SAVEPOINT elimina el marcador
• Demasiados savepoints añaden sobrecarga
• Los ORM pueden no exponer los savepoints

4. Violación de Restricción Revierte la Sentencia

El fallo de una única sentencia en autocommit aborta solo esa sentencia.

INSERT INTO app.accounts (id, name) VALUES (1, 'dup'); -- falla si id=1 existe

• En una TX explícita, el error aborta la TX hasta un ROLLBACK
• Usa SAVEPOINT para reintentar dentro de la TX
• Maneja SQLSTATE en la aplicación

5. Lee Tus Escrituras

La misma sesión ve los cambios confirmados.

BEGIN;
INSERT INTO app.accounts (name) VALUES ('NewCo') RETURNING id;
-- la misma TX ve la fila
COMMIT;

• Otras sesiones ven la fila después del commit
• El nivel de aislamiento afecta las lecturas concurrentes
• RETURNING evita un segundo viaje de ida y vuelta

6. Restricciones Retardables (Deferrable)

Comprueba la FK en el momento del commit.

SET CONSTRAINTS ALL DEFERRED;
BEGIN;
-- reordena las inserciones dentro de la TX
COMMIT;

• Solo las restricciones DEFERRABLE participan
• Raro; prefiere el orden de inserción correcto
• Documenta cuándo se usa en cargas masivas

Ejemplos Intermedios

7. Patrón de Transacción de Aplicación

Forma pseudo-código para servicios.

-- Sesión SQL
BEGIN;
-- sentencias de negocio
COMMIT;

• Una operación de negocio por transacción cuando sea posible
• Evita el tiempo de espera del usuario dentro de la TX
• Establece statement_timeout y lock_timeout

8. Implicación de Dos Fases

Transacciones preparadas para coordinadores externos.

PREPARE TRANSACTION 'txn_abc';
-- más tarde: COMMIT PREPARED 'txn_abc';

• Raro fuera de integraciones XA
• Las transacciones preparadas bloquean el vacuum si se abandonan
• Monitoriza pg_prepared_xacts

9. Observar Transacciones Abiertas

Estado de pg_stat_activity.

SELECT pid, xact_start, state, query
FROM pg_stat_activity
WHERE state IN ('idle in transaction','active');

• 'idle in transaction' es una causa principal de incidentes
• idle_in_transaction_session_timeout lo mitiga
• Mata backends solo con el playbook de operaciones

Versiones de Stack: Esta página fue escrita para PostgreSQL 18.4 (estable 18, mantenimiento 17), pgvector 0.8+, PgBouncer 1.x, Patroni 3.x, y PostGIS 3.5+.