En el backend todo luce impecable: las peticiones pasan por Zod o Pydantic y las pruebas están en verde. Abres el lunes la base de producción y te encuentras dos usuarios con el mismo login, una nota de 150 cuando el máximo es cien y una referencia a un equipo borrado. Sorpresa. Y el código no lanzó ni un solo error.
Por qué poner reglas en el esquema si ya valida el backend
«Un momento, ¿para qué duplicar reglas en SQL si el backend ya lo filtra todo?», es una duda razonable. La respuesta es sencilla: tu servicio casi nunca es la única puerta de entrada a la base de datos.
Pronto aparecen al lado un worker, un script de migración o un segundo microservicio, y algún viernes alguien edita filas a mano. La validación en tu código no sabe nada de esos accesos.
Incluso un único backend se rompe con una condición de carrera. Dos personas eligen el usuario alex al mismo tiempo: el código ejecuta SELECT ... WHERE user_name = 'alex', ambos ven que está libre y lanzan el INSERT. Bienvenido, duplicado.
El validador de la aplicación avisa con amabilidad dónde se equivocó el usuario. Las restricciones del esquema (definidas mediante DDL, comandos de estructura como CREATE TABLE y ALTER TABLE) actúan como la última línea de defensa frente a cualquier servicio, script o hilo paralelo.
Seis restricciones sobre un mismo esquema
Veamos las seis reglas de la documentación de restricciones de PostgreSQL aplicadas a las tablas teams, users y workspaces:
-- Equipos: clave primaria y nombre obligatorio
CREATE TABLE teams (
id INTEGER GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
name TEXT NOT NULL
);
-- Usuarios: login único y referencia al equipo
CREATE TABLE users (
id INTEGER GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
display_name TEXT NOT NULL,
user_name TEXT NOT NULL UNIQUE,
team_id INTEGER NOT NULL
REFERENCES teams(id) ON DELETE RESTRICT
);
-- Espacios de trabajo: puntaje 0..100 y fecha por defecto
CREATE TABLE workspaces (
id INTEGER GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
team_id INTEGER NOT NULL
REFERENCES teams(id) ON DELETE CASCADE,
score NUMERIC(5, 2) NOT NULL CHECK (score BETWEEN 0 AND 100),
created_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP
);
PRIMARY KEY asigna a cada fila un número único y prohíbe NULL. NOT NULL impide vacíos en campos obligatorios. UNIQUE garantiza la unicidad del login en toda la tabla y resuelve las condiciones de carrera de forma atómica dentro del motor.
FOREIGN KEY (mediante REFERENCES) cuida la integridad referencial: en team_id no puedes insertar un equipo inexistente, así que nunca habrá filas huérfanas. CHECK evalúa una condición en cada inserción y actualización (score se mantiene en 0..100). DEFAULT rellena un valor automáticamente si el campo se omitió en el INSERT (en PostgreSQL es formalmente una propiedad de la columna más que una restricción, pero suele agruparse con ellas).
Cualquier intento de colar datos rotos recibe un rechazo inmediato del motor:
-- El puntaje 150 se sale de CHECK (0..100)
INSERT INTO workspaces (team_id, score) VALUES (1, 150);
-- ERROR: new row violates check constraint "workspaces_score_check"
-- No existe ningún equipo con id = 999 en teams
INSERT INTO users (display_name, user_name, team_id)
VALUES ('Ana', 'anya_dev', 999);
-- ERROR: insert or update violates foreign key "users_team_id_fkey"
El fallo salta al instante de escribir, no un mes después en un reporte roto o un job nocturno caído.
Trampas con NULL, cascadas y tablas grandes
La primera emboscada es NULL dentro de CHECK. Si pones CHECK (score BETWEEN 0 AND 100) sin NOT NULL, la tabla aceptará tranquilamente score = NULL. Comparar NULL con un número en SQL devuelve UNKNOWN, no FALSE, y CHECK lo deja pasar. Si quieres prohibir vacíos, pon NOT NULL al lado.
La segunda trampa vive en UNIQUE. Por estándar, dos NULL no son iguales entre sí, así que un UNIQUE común dejará pasar todas las filas vacías que quieras. Si necesitas como máximo un NULL, en PostgreSQL 15+ se añade NULLS NOT DISTINCT.
El tercer campo minado es ON DELETE en claves foráneas. ON DELETE RESTRICT en users impide borrar un equipo que aún tenga personas. En cambio, ON DELETE CASCADE (borrado en cascada) en workspaces eliminará en silencio todos sus espacios. Poner CASCADE por inercia es peligroso: un solo DELETE puede barrer media base de datos.
Y un detalle clave de producción: un ALTER TABLE ... ADD CHECK normal sobre una tabla grande bloquea las escrituras mientras escanea toda la tabla. En PostgreSQL primero se añade la regla con NOT VALID y en un segundo paso se validan las filas antiguas:
-- Permitimos como máximo un NULL en un campo único (PostgreSQL 15+)
ALTER TABLE users
ADD COLUMN external_id TEXT,
ADD CONSTRAINT users_ext_uniq
UNIQUE NULLS NOT DISTINCT (external_id);
-- Añadimos CHECK sin bloqueo largo de escritura y luego validamos lo previo
ALTER TABLE workspaces
ADD CONSTRAINT ws_score_chk CHECK (score BETWEEN 0 AND 100) NOT VALID;
ALTER TABLE workspaces VALIDATE CONSTRAINT ws_score_chk;
Tras NOT VALID, los registros nuevos se comprueban de inmediato, mientras VALIDATE CONSTRAINT revisa las filas existentes bajo un bloqueo suave sin detener el servicio.

