13. Persistencia Relacional con PostgreSQL: Connection Pooling y Transacciones ACID
Conecta tu API a PostgreSQL utilizando el pool de conexiones del driver pg, previene inyecciones SQL mediante consultas parametrizadas y ejecuta transacciones ACID atómicas con BEGIN/COMMIT/ROLLBACK.
PostgreSQL de Alto Rendimiento con pg.Pool
Abrir y cerrar una conexión TCP hacia PostgreSQL en cada petición HTTP añade entre 30 y 100 ms de latencia por solicitud. Con pg.Pool, mantenemos un conjunto de conexiones calientes listas para ser reutilizadas al instante por el bucle de eventos de Node.js.
1. Consultas Parametrizadas contra Inyección SQL
Nunca concatenes variables dentro de una consulta SQL (SELECT * FROM usuarios WHERE email = '${email}'). El driver nativo pg provee consultas parametrizadas donde los valores se transmiten separados del texto de la sentencia, enviándolos al motor de PostgreSQL como parámetros $1, $2:
2. Transacciones ACID Atómicas con BEGIN / COMMIT / ROLLBACK
En operaciones críticas como crear una orden de compra y descontar stock simultáneamente, ambas deben tener éxito o ninguna debe aplicarse (Atomicidad). Para transacciones, es obligatorio obtener un cliente exclusivo del pool mediante await pool.connect() y liberarlo en el bloque finally con client.release().
⚡ Configuración de pg.Pool y Transacción Atómica de Pago
Ejecución de transacciones seguras con liberación garantizada de conexiones.
import pg from 'pg';
const { Pool } = pg;
// 1. CONFIGURACIÓN DEL POOL DE CONEXIONES POSTGRESQL
export const pool = new Pool({
connectionString: process.env.DATABASE_URL,
max: 20, // Máximo 20 conexiones simultáneas por instancia
idleTimeoutMillis: 30000, // Cerrar conexiones ociosas tras 30 segundos
connectionTimeoutMillis: 2000, // Fallar rápido si la BD no responde en 2 segundos
ssl: process.env.NODE_ENV === 'production' ? { rejectUnauthorized: false } : false,
});
pool.on('error', (err) => {
console.error('[PostgreSQL] Error inesperado en cliente inactivo del pool:', err);
});
// 2. FUNCIÓN DE TRANSACCIÓN ATÓMICA (Ejemplo: Crear Pedido y Descontar Inventario)
export async function executeOrderTransaction({ usuarioId, productoId, cantidad, total }) {
// Obtener un cliente dedicado del pool para toda la duración de la transacción
const client = await pool.connect();
try {
// Iniciar bloque transaccional
await client.query('BEGIN');
// Paso 1: Verificar y descontar stock (con bloqueo de fila FOR UPDATE para evitar Race Conditions)
const stockResult = await client.query(
`UPDATE inventario
SET stock = stock - $1, updated_at = NOW()
WHERE producto_id = $2 AND stock >= $1
RETURNING stock`,
[cantidad, productoId]
);
if (stockResult.rowCount === 0) {
throw new Error('Stock insuficiente para completar el pedido.');
}
// Paso 2: Crear el registro del pedido
const orderResult = await client.query(
`INSERT INTO pedidos (usuario_id, producto_id, cantidad, total, estado)
VALUES ($1, $2, $3, $4, 'pagado')
RETURNING id, estado, created_at`,
[usuarioId, productoId, cantidad, total]
);
// Confirmar todos los cambios de forma irreversible
await client.query('COMMIT');
return orderResult.rows[0];
} catch (error) {
// Si cualquier operación falla, revertir absolutamente todos los cambios
await client.query('ROLLBACK');
throw error;
} finally {
// OBLIGATORIO: Devolver el cliente al pool para no agotar las conexiones
client.release();
}
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Por qué es indispensable llamar a client.release() dentro de un bloque finally al ejecutar transacciones con un cliente obtenido de pg.Pool?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Express.js: Framework Backend & APIs Empresariales y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.