Conceptos básicos de Triggers

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

Prerrequisitos

Tabla con INSERT/UPDATE que puedas modificar en desarrollo.

# 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. Trigger AFTER INSERT por fila

Se ejecuta por cada fila insertada.

CREATE OR REPLACE FUNCTION app.log_insert() RETURNS trigger
LANGUAGE plpgsql AS $$
BEGIN
  RAISE NOTICE 'insertado %', NEW.id;
  RETURN NEW;
END;
$$;
CREATE TRIGGER tr_log_insert AFTER INSERT ON app.accounts
FOR EACH ROW EXECUTE FUNCTION app.log_insert();

• RETURN NEW en triggers por fila
• Los triggers AFTER no pueden cambiar la fila
• Usar NOTICE solo en desarrollo

2. Trigger BEFORE UPDATE por fila

Puede modificar NEW antes de escribir.

CREATE OR REPLACE FUNCTION app.touch_updated() RETURNS trigger
LANGUAGE plpgsql AS $$
BEGIN
  NEW.updated_at := now();
  RETURN NEW;
END;
$$;

• BEFORE UPDATE establece columnas de NEW
• Común para updated_at
• Prefiere GENERATED o la capa de aplicación si es simple

3. Trigger a nivel de sentencia

Se ejecuta una vez por sentencia SQL.

CREATE TRIGGER tr_stmt AFTER UPDATE ON app.accounts
FOR EACH STATEMENT EXECUTE FUNCTION app.log_insert();

• Sin variables de fila NEW/OLD
• Usa tablas de transición para auditoría masiva
• Más barato por fila en actualizaciones masivas

4. DROP Trigger

Eliminar cuando la lógica se mueve a la aplicación.

DROP TRIGGER IF EXISTS tr_log_insert ON app.accounts;

• Las migraciones deben hacer DROP antes de CREATE
• Los triggers huérfanos confunden la depuración
• Documentar la propiedad

5. Momento de ejecución del Trigger

Elección entre BEFORE y AFTER.

-- BEFORE: validar/modificar NEW
-- AFTER: auditar/efectos secundarios que referencian la fila final

• BEFORE para validación y valores predeterminados
• AFTER para auditoría y fan-out
• INSTEAD OF solo en vistas

6. Cláusula WHEN

Ejecución condicional del trigger.

CREATE TRIGGER tr_status AFTER UPDATE OF status ON app.orders
FOR EACH ROW WHEN (OLD.status IS DISTINCT FROM NEW.status)
EXECUTE FUNCTION app.log_insert();

• Reduce el ruido en actualizaciones amplias
• No puede referenciar otras tablas
• Probar con actualizaciones masivas

Ejemplos intermedios

7. Orden de Múltiples Triggers

Por defecto, orden alfabético por nombre.

CREATE TRIGGER a_first BEFORE INSERT ON app.accounts FOR EACH ROW EXECUTE FUNCTION app.touch_updated();
CREATE TRIGGER b_second BEFORE INSERT ON app.accounts FOR EACH ROW EXECUTE FUNCTION app.log_insert();

• Nombra los triggers según el orden deseado
• Evita modificar conflictos en BEFORE
• Consolida triggers pequeños cuando sea posible

8. Trigger de Restricción

Comprobación de restricciones diferida.

-- CONSTRAINT TRIGGER ... DEFERRABLE INITIALLY DEFERRED

• Raro; FK y CHECK suelen ser suficientes
• Se ejecuta al final del commit
• Más difícil de depurar

9. Deshabilitar Trigger de Sesión

session_replication_role o ALTER TABLE DISABLE.

ALTER TABLE app.accounts DISABLE TRIGGER tr_log_insert;
-- carga masiva
ALTER TABLE app.accounts ENABLE TRIGGER tr_log_insert;

• Requiere superusuario o propietario
• Documentar ventanas de mantenimiento
• Volver a habilitar antes de devolver el tráfico de la aplicación

Versiones de la pila: Esta página se escribió para PostgreSQL 18.4 (estable 18, mantenimiento 17), pgvector 0.8+, PgBouncer 1.x, Patroni 3.x y PostGIS 3.5+.