Conexión y uso de MySQL con Node.js

MySQL es una de las bases de datos relacionales de código abierto más populares, y Node.js es un entorno de ejecución de JavaScript basado en el motor Chrome V8. Combinar ambos permite construir potentes servicios backend.

¿Por qué elegir MySQL + Node.js?

  • MySQL ofrece almacenamiento y gestión de datos confiables
  • El modelo de E/S no bloqueante de Node.js es adecuado para operaciones de base de datos
  • Desarrollo full-stack con JavaScript (mismo lenguaje en frontend y backend)
  • El ecosistema npm tiene muchos paquetes relacionados con MySQL

Instalación de dependencias necesarias

Antes de comenzar, necesitamos instalarmysql2paquete, que es una opción popular para conectar MySQL en Node.js.

npm install mysql2

¿Por qué elegir mysql2 en lugar de mysql?

  • Mejor rendimiento
  • Soporte para la API de Promise
  • Soporte para sentencias preparadas
  • Mantenimiento activo

Establecer conexión a la base de datos

Configuración básica de conexión

Ejemplo

const mysql = require('mysql2');

// Crear grupo de conexiones (recomendado para producción)
const pool = mysql.createPool({
  host: 'localhost',     // Dirección del servidor de base de datos
  user: 'root',          // Nombre de usuario de la base de datos
  password: 'password',  // Contraseña de la base de datos
  database: 'test_db',   // Nombre de la base de datos a conectar
  waitForConnections: true,
  connectionLimit: 10,   // Número máximo de conexiones del pool de conexiones
  queueLimit: 0
});

// Obtener una versión Promise de la conexión
const promisePool = pool.promise();

Pool de conexiones vs conexión única

Ventajas del pool de conexiones:

  • Reutilizar conexiones, reduciendo la sobrecarga
  • Gestionar automáticamente el ciclo de vida de las conexiones
  • Prevenir fugas de conexiones
  • Mejor rendimiento

Escenarios adecuados para conexión única:

  • Scripts simples
  • Entorno de pruebas
  • Aplicaciones de baja concurrencia

Ejecutar operaciones CRUD básicas

Consultar datos (SELECT)

Ejemplo

async function getUsers() {
  try {
    const [rows, fields] = await promisePool.query('SELECT * FROM users');
    console.log(rows);
    return rows;
  } catch (err) {
    console.error('Error de consulta:', err);
    throw err;
  }
}

Insertar datos (INSERT)

Ejemplo

async function addUser(user) {
  try {
    const [result] = await promisePool.query(
      'INSERT INTO users (name, email) VALUES (?, ?)',
      [user.name, user.email]
    );
    console.log('ID de inserción:', result.insertId);
    return result;
  } catch (err) {
    console.error('Error de inserción:', err);
    throw err;
  }
}

Actualizar datos (UPDATE)

Ejemplo

async function updateUser(id, updates) {
  try {
    const [result] = await promisePool.query(
      'UPDATE users SET name = ?, email = ? WHERE id = ?',
      [updates.name, updates.email, id]
    );
    console.log('Filas afectadas:', result.affectedRows);
    return result;
  } catch (err) {
    console.error('Error de actualización:', err);
    throw err;
  }
}

Eliminar datos (DELETE)

Ejemplo

async function deleteUser(id) {
  try {
    const [result] = await promisePool.query(
      'DELETE FROM users WHERE id = ?',
      [id]
    );
    console.log('Filas eliminadas:', result.affectedRows);
    return result;
  } catch (err) {
    console.error('Error de eliminación:', err);
    throw err;
  }
}

Funciones avanzadas y mejores prácticas

Manejo de transacciones

Ejemplo

async function transferFunds(fromId, toId, amount) {
  let connection;
  try {
    // Obtener una conexión del pool de conexiones
    connection = await promisePool.getConnection();
   
    // Iniciar transacción
    await connection.beginTransaction();
   
    // Ejecutar la operación de transferencia
    await connection.query(
      'UPDATE accounts SET balance = balance - ? WHERE id = ?',
      [amount, fromId]
    );
   
    await connection.query(
      'UPDATE accounts SET balance = balance + ? WHERE id = ?',
      [amount, toId]
    );
   
    // Confirmar transacción
    await connection.commit();
    console.log('Transferencia exitosa');
  } catch (err) {
    // Revertir en caso de error
    if (connection) await connection.rollback();
    console.error('Error de transferencia:', err);
    throw err;
  } finally {
    // Devolver la conexión al pool de conexiones
    if (connection) connection.release();
  }
}

Sentencias preparadas

Las sentencias preparadas pueden mejorar el rendimiento y prevenir la inyección SQL:

Ejemplo

async function getUserById(id) {
  try {
    // Preparar la sentencia preparada
    const [rows] = await promisePool.execute(
      'SELECT * FROM users WHERE id = ?',
      [id]
    );
    return rows[0];
  } catch (err) {
    console.error('Error de consulta:', err);
    throw err;
  }
}

Escucha de eventos del pool de conexiones

Ejemplo

pool.on('connection', (connection) => {
  console.log('Nueva conexión establecida');
});

pool.on('acquire', (connection) => {
  console.log('Conexión obtenida');
});

pool.on('release', (connection) => {
  console.log('Conexión liberada');
});

pool.on('enqueue', () => {
  console.log('Esperando conexión disponible');
});

Manejo de errores y depuración

Tipos de errores comunes

  1. Error de conexión: servidor de base de datos inalcanzable, fallo de autenticación, etc.
  2. Error de sintaxis en la consulta: la sentencia SQL es incorrecta
  3. Violación de restricciones: como clave primaria duplicada, restricciones de clave externa, etc.
  4. Error de tiempo de espera: la consulta tarda demasiado en ejecutarse

Estrategias de manejo de errores

Ejemplo

async function safeQuery(sql, params) {
  try {
    const [rows] = await promisePool.query(sql, params);
    return rows;
  } catch (err) {
    // Tomar diferentes medidas según el tipo de error
    switch (err.code) {
      case 'ER_DUP_ENTRY':
        console.warn('Entrada duplicada:', err.sqlMessage);
        throw new Error('Los datos ya existen');
      case 'ECONNREFUSED':
        console.error('No se pudo conectar a la base de datos');
        throw new Error('Servicio no disponible, inténtelo de nuevo más tarde');
      default:
        console.error('Error de base de datos:', err);
        throw err;
    }
  }
}

Sugerencias para optimización del rendimiento

  1. Configurar adecuadamente el tamaño del pool de conexiones: normalmente de 2 a 3 veces el número de núcleos de CPU
  2. Usar un pool de conexiones en lugar de una conexión única: especialmente en aplicaciones web
  3. Usar índices adecuadamente: acelerar el rendimiento de las consultas
  4. Operaciones por lotes: reducir el número de idas y vueltas (round-trips)
  5. Usar sentencias preparadas: mejorar el rendimiento de consultas repetidas
  6. Liberar recursos periódicamente: evitar fugas de conexiones

Ejemplo de inserción por lotes:

Ejemplo

async function batchInsertUsers(users) {
  const values = users.map(user => [user.name, user.email]);
 
  try {
    const [result] = await promisePool.query(
      'INSERT INTO users (name, email) VALUES ?',
      [values]
    );
    console.log('Filas insertadas:', result.affectedRows);
    return result;
  } catch (err) {
    console.error('Error en la inserción masiva:', err);
    throw err;
  }
}

Consideraciones de seguridad

  1. Nunca concatenes cadenas SQL: usa consultas parametrizadas para prevenir la inyección SQL
  2. Limita los permisos del usuario de la base de datos: la cuenta de la aplicación solo necesita los permisos necesarios
  3. Cifra datos sensibles: por ejemplo, las contraseñas deben almacenarse con hash y sal
  4. Usa conexiones SSL: en producción se recomienda cifrar la conexión
  5. Actualiza las dependencias periódicamente: mantén el paquete mysql2 en su versión más reciente

Estructura completa del proyecto de ejemplo

project/
├── config/
│   └── db.js          # 数据库配置
├── models/
│   └── userModel.js   # 数据模型
├── services/
│   └── userService.js # 业务逻辑
├── app.js             # 主应用文件
└── package.json

Ejemplo de db.js:

Ejemplo

const mysql = require('mysql2');

const pool = mysql.createPool({
  host: process.env.DB_HOST || 'localhost',
  user: process.env.DB_USER || 'root',
  password: process.env.DB_PASSWORD || '',
  database: process.env.DB_NAME || 'test_db',
  waitForConnections: true,
  connectionLimit: 10,
  queueLimit: 0
});

module.exports = pool.promise();
Otras extensiones