Подключение и использование MySQL в Node.js

MySQL — одна из самых популярных реляционных баз данных с открытым исходным кодом, а Node.js — это среда выполнения JavaScript на основе движка Chrome V8. Их сочетание позволяет создавать мощные серверные сервисы.

Почему стоит выбрать MySQL + Node.js?

  • MySQL обеспечивает надёжное хранение и управление данными
  • Неблокирующая модель ввода-вывода Node.js подходит для операций с базами данных
  • Full-stack-разработка на JavaScript (использование одного и того же языка для фронтенда и бэкенда)
  • Богатая экосистема npm содержит множество пакетов, связанных с MySQL

Установка необходимых зависимостей

Прежде чем начать, нам нужно установитьmysql2пакет, который часто выбирают для подключения к MySQL в Node.js.

npm install mysql2

Почему стоит выбрать mysql2 вместо mysql?

  • Лучшая производительность
  • Поддерживает Promise API
  • Поддерживает подготовленные выражения
  • Активная поддержка

Установление соединения с базой данных

Базовая конфигурация подключения

Пример

const mysql = require('mysql2');

// Создать пул соединений (рекомендуется для продакшена)
const pool = mysql.createPool({
  host: 'localhost',     // Адрес сервера базы данных
  user: 'root',          // Имя пользователя базы данных
  password: 'password',  // Пароль базы данных
  database: 'test_db',   // Имя базы данных для подключения
  waitForConnections: true,
  connectionLimit: 10,   // Максимальное количество соединений в пуле
  queueLimit: 0
});

// Получить соединение на основе Promise
const promisePool = pool.promise();

Пул соединений против одиночного соединения

Преимущества пула соединений:

  • Повторное использование соединений, снижение накладных расходов
  • Автоматическое управление жизненным циклом соединений
  • Предотвращение утечек соединений
  • Лучшая производительность

Сценарии, подходящие для одного соединения:

  • Простые скрипты
  • Тестовая среда
  • Приложения с низкой конкурентностью

Выполнение базовых CRUD-операций

Запрос данных (SELECT)

Пример

async function getUsers() {
  try {
    const [rows, fields] = await promisePool.query('SELECT * FROM users');
    console.log(rows);
    return rows;
  } catch (err) {
    console.error('Ошибка запроса:', err);
    throw err;
  }
}

Вставка данных (INSERT)

Пример

async function addUser(user) {
  try {
    const [result] = await promisePool.query(
      'INSERT INTO users (name, email) VALUES (?, ?)',
      [user.name, user.email]
    );
    console.log('ID вставки:', result.insertId);
    return result;
  } catch (err) {
    console.error('Ошибка вставки:', err);
    throw err;
  }
}

Обновление данных (UPDATE)

Пример

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('Затронуто строк:', result.affectedRows);
    return result;
  } catch (err) {
    console.error('Ошибка обновления:', err);
    throw err;
  }
}

Удаление данных (DELETE)

Пример

async function deleteUser(id) {
  try {
    const [result] = await promisePool.query(
      'DELETE FROM users WHERE id = ?',
      [id]
    );
    console.log('Удалено строк:', result.affectedRows);
    return result;
  } catch (err) {
    console.error('Ошибка удаления:', err);
    throw err;
  }
}

Расширенные возможности и лучшие практики

Обработка транзакций

Пример

async function transferFunds(fromId, toId, amount) {
  let connection;
  try {
    // Получить соединение из пула
    connection = await promisePool.getConnection();
   
    // Начать транзакцию
    await connection.beginTransaction();
   
    // Выполнить операцию перевода
    await connection.query(
      'UPDATE accounts SET balance = balance - ? WHERE id = ?',
      [amount, fromId]
    );
   
    await connection.query(
      'UPDATE accounts SET balance = balance + ? WHERE id = ?',
      [amount, toId]
    );
   
    // Зафиксировать транзакцию
    await connection.commit();
    console.log('Перевод выполнен успешно');
  } catch (err) {
    // Откатить изменения при ошибке
    if (connection) await connection.rollback();
    console.error('Перевод не выполнен:', err);
    throw err;
  } finally {
    // Вернуть соединение обратно в пул
    if (connection) connection.release();
  }
}

Подготовленные выражения

Подготовленные выражения могут повысить производительность и предотвратить SQL-инъекции:

Пример

async function getUserById(id) {
  try {
    // Создать подготовленное выражение
    const [rows] = await promisePool.execute(
      'SELECT * FROM users WHERE id = ?',
      [id]
    );
    return rows[0];
  } catch (err) {
    console.error('Ошибка запроса:', err);
    throw err;
  }
}

Прослушивание событий пула соединений

Пример

pool.on('connection', (connection) => {
  console.log('Новое соединение установлено');
});

pool.on('acquire', (connection) => {
  console.log('Соединение получено');
});

pool.on('release', (connection) => {
  console.log('Соединение освобождено');
});

pool.on('enqueue', () => {
  console.log('Ожидание доступного соединения');
});

Обработка ошибок и отладка

Распространённые типы ошибок

  1. Ошибки соединения: сервер базы данных недоступен, ошибка аутентификации и т.д.
  2. Ошибки синтаксиса запроса: некорректные SQL-инструкции
  3. Нарушения ограничений: например, дубликаты первичных ключей, ограничения внешних ключей и т. д.
  4. Ошибки тайм-аута: время выполнения запроса слишком велико

Стратегии обработки ошибок

Пример

async function safeQuery(sql, params) {
  try {
    const [rows] = await promisePool.query(sql, params);
    return rows;
  } catch (err) {
    // Принимайте разные меры в зависимости от типа ошибки
    switch (err.code) {
      case 'ER_DUP_ENTRY':
        console.warn('Дубликат записи:', err.sqlMessage);
        throw new Error('Данные уже существуют');
      case 'ECONNREFUSED':
        console.error('Не удалось подключиться к базе данных');
        throw new Error('Сервис недоступен, попробуйте позже');
      default:
        console.error('Ошибка базы данных:', err);
        throw err;
    }
  }
}

Советы по оптимизации производительности

  1. Установите размер пула соединений соответствующим образом: обычно в 2-3 раза больше количества ядер CPU
  2. Используйте пул соединений вместо одного соединения: особенно в веб-приложениях
  3. Используйте индексы надлежащим образом: повышает производительность запросов
  4. Пакетные операции: сокращают количество сетевых вызовов
  5. Используйте подготовленные запросы: повышают производительность повторяющихся запросов
  6. Регулярно освобождайте ресурсы: избегайте утечек соединений

Пример пакетной вставки:

Пример

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('Вставлено строк:', result.affectedRows);
    return result;
  } catch (err) {
    console.error('Ошибка пакетной вставки:', err);
    throw err;
  }
}

Вопросы безопасности

  1. Никогда не конкатенируйте строки SQL: используйте параметризованные запросы для предотвращения SQL-инъекций
  2. Ограничьте права пользователя базы данных: учетным записям приложения нужны только необходимые права
  3. Шифруйте конфиденциальные данные: например, пароли должны храниться в виде хешей с солью
  4. Используйте SSL-соединения: в рабочей среде рекомендуются зашифрованные соединения
  5. Регулярно обновляйте зависимости: поддерживайте пакет mysql2 в актуальном состоянии

Полная структура примера проекта

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

Пример db.js:

Пример

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();
Другие расширения