Экспорт и импорт базы MySQL/MariaDB на Linux VPS

Перенос сайта, восстановление из резервной копии или клонирование тестовой среды сводятся к двум операциям: выгрузить базу в файл и загрузить её обратно. На VPS Linux Infrawire обе делаются несколькими командами и без веб-интерфейса. В руководстве разобраны согласованные дампы, сжатие, большие файлы, кодировка символов и прямая передача между серверами.

📋 Требования

Linux VPS с Ubuntu 24.04 или Debian 12 и доступом по SSH под root (IP-адрес и пароль root есть в вашем личном кабинете)
Установленный MySQL или MariaDB либо хотя бы клиент (apt install mariadb-client)
Пользователь базы данных с правами SELECT, SHOW VIEW, TRIGGER, LOCK TABLES и EVENT на выгружаемую базу
Достаточно свободного места на диске: проверьте командой df -h

1. Экспорт базы с помощью mysqldump

Для таблиц InnoDB (движок по умолчанию) параметр --single-transaction создаёт согласованный снимок без блокировки таблиц, поэтому сайт продолжает работать во время выгрузки.

Bash
1mysqldump -u USER -p --single-transaction --quick DBNAME > DBNAME.sql

В свежих версиях MariaDB эта утилита доступна и как mariadb-dump с теми же параметрами.

2. Процедуры, триггеры и события

Триггеры выгружаются по умолчанию, а хранимые процедуры, функции и запланированные события нужно запрашивать явно. Явно заданная кодировка избавляет от проблем с кириллицей и эмодзи.

Bash
1mysqldump -u USER -p --single-transaction --routines --triggers --events \
2  --default-character-set=utf8mb4 DBNAME > DBNAME.sql

Полезные варианты:

Bash
1# Только структура, без строк
2mysqldump -u USER -p --no-data DBNAME > schema.sql
3# Несколько баз с командами CREATE DATABASE
4mysqldump -u USER -p --single-transaction --databases DB1 DB2 > two-dbs.sql
5# Все базы сервера
6mysqldump -u root -p --single-transaction --routines --events --all-databases > all.sql

3. Сжатие дампа с помощью gzip

SQL-текст отлично сжимается. Направьте вывод прямо в gzip, чтобы несжатый файл вообще не записывался на диск.

Bash
1mysqldump -u USER -p --single-transaction --routines --events DBNAME | gzip > DBNAME_$(date +%F).sql.gz

Чтобы не вводить пароль каждый раз (и не светить его в выводе ps), сохраните его в ~/.my.cnf:

INI
[client]
user=USER
password=YOUR_PASSWORD

Bash
1chmod 600 ~/.my.cnf

4. Импорт дампа

Сначала создайте целевую базу с современной кодировкой, затем загрузите файл.

Bash
1mysql -u USER -p -e 'CREATE DATABASE IF NOT EXISTS DBNAME CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;'
2mysql -u USER -p --default-character-set=utf8mb4 DBNAME < DBNAME.sql
3# Из сжатого файла
4gunzip -c DBNAME.sql.gz | mysql -u USER -p --default-character-set=utf8mb4 DBNAME

Внимание: по умолчанию дамп содержит DROP TABLE IF EXISTS, поэтому импорт в существующую базу заменяет таблицы с теми же именами. Сначала сделайте резервную копию целевой базы.

5. Работа с большими файлами

Для дампов в несколько гигабайт запускайте импорт внутри tmux, чтобы обрыв SSH-сессии его не прервал, а прогресс отслеживайте через pv.

Bash
1apt install -y tmux pv
2tmux new -s import
3pv DBNAME.sql.gz | gunzip | mysql -u USER -p --max-allowed-packet=512M DBNAME

Отключитесь сочетанием Ctrl+B, затем D, а позже вернитесь командой tmux attach -t import.

6. Прямая передача на другой сервер по SSH

Промежуточный файл не нужен: дамп идёт по зашифрованному SSH-конвейеру и загружается на месте. Учётные данные читаются из ~/.my.cnf (или через локальный сокет для root) с обеих сторон.

Bash
1mysqldump --single-transaction --routines --events DBNAME | gzip \
2  | ssh root@NEW_VPS_IP 'gunzip | mysql DBNAME'

База DBNAME должна уже существовать на целевом сервере.

✅ Проверка результата

Bash
1gzip -t DBNAME.sql.gz && echo 'archive OK'
2mysql -e 'SHOW TABLES;' DBNAME
3mysql -e 'SELECT COUNT(*) FROM TABLENAME;' DBNAME
4mysql -e "SELECT default_character_set_name FROM information_schema.SCHEMATA WHERE schema_name='DBNAME';"

Сравните число строк в нескольких ключевых таблицах на источнике и на целевом сервере.

🔧 Устранение неполадок

ERROR 1045 Access denied : неверный пользователь или пароль, либо пользователю запрещено подключаться с этого хоста. Сначала проверьте вход командой mysql -u USER -p.

ERROR 2006 MySQL server has gone away : строка или запрос превышает max_allowed_packet. Увеличьте значение на сервере в разделе [mysqld] конфигурации и перезапустите службу либо передайте клиенту --max-allowed-packet=512M.

Нечитаемые символы после импорта : файл прочитан в неправильной кодировке. Экспортируйте с --default-character-set=utf8mb4 и импортируйте с тем же параметром.

ERROR 1227 или ошибки DEFINER : дамп ссылается на пользователя, которого нет на целевом сервере. Удалите эту часть при импорте:

Bash
1sed -E 's/DEFINER=`[^`]+`@`[^`]+`//g' DBNAME.sql | mysql -u USER -p DBNAME

🎉 Теперь ваши базы данных легко копировать, восстанавливать и переносить между серверами!