Tema 13 · PostgreSQL & pg Pool

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:

await pool.query('SELECT * FROM usuarios WHERE email = $1 AND activo = $2', [email, true]);

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.

dbService.js
Solo lectura
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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.