Подключение и использование 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();
// Создать пул соединений (рекомендуется для продакшена)
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;
}
}
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;
}
}
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;
}
}
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;
}
}
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();
}
}
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;
}
}
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('Ожидание доступного соединения');
});
console.log('Новое соединение установлено');
});
pool.on('acquire', (connection) => {
console.log('Соединение получено');
});
pool.on('release', (connection) => {
console.log('Соединение освобождено');
});
pool.on('enqueue', () => {
console.log('Ожидание доступного соединения');
});
Обработка ошибок и отладка
Распространённые типы ошибок
- Ошибки соединения: сервер базы данных недоступен, ошибка аутентификации и т.д.
- Ошибки синтаксиса запроса: некорректные SQL-инструкции
- Нарушения ограничений: например, дубликаты первичных ключей, ограничения внешних ключей и т. д.
- Ошибки тайм-аута: время выполнения запроса слишком велико
Стратегии обработки ошибок
Пример
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;
}
}
}
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;
}
}
}
Советы по оптимизации производительности
- Установите размер пула соединений соответствующим образом: обычно в 2-3 раза больше количества ядер CPU
- Используйте пул соединений вместо одного соединения: особенно в веб-приложениях
- Используйте индексы надлежащим образом: повышает производительность запросов
- Пакетные операции: сокращают количество сетевых вызовов
- Используйте подготовленные запросы: повышают производительность повторяющихся запросов
- Регулярно освобождайте ресурсы: избегайте утечек соединений
Пример пакетной вставки:
Пример
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;
}
}
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;
}
}
Вопросы безопасности
- Никогда не конкатенируйте строки SQL: используйте параметризованные запросы для предотвращения SQL-инъекций
- Ограничьте права пользователя базы данных: учетным записям приложения нужны только необходимые права
- Шифруйте конфиденциальные данные: например, пароли должны храниться в виде хешей с солью
- Используйте SSL-соединения: в рабочей среде рекомендуются зашифрованные соединения
- Регулярно обновляйте зависимости: поддерживайте пакет 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();
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();