Гайды

Почему бэкап базы не восстанавливается — три причины и как починить

Иллюстрация: запечатанный ящик и ключ, который не входит в замок

Файл бэкапа есть. Он весит триста мегабайт. Ты уверенно запускаешь восстановление — и получаешь ошибку на первой же секунде.

Плохая новость: узнают об этом обычно в самый неподходящий день. Хорошая: почти всегда дело в одной из трёх вещей, и ни одна из них не означает, что данные потеряны.

Разберём по порядку — от самой частой.

Симптом: восстановление падает сразу или молча делает не то

Как это выглядит:

  • команда обрывается с сообщением про версию сервера;
  • в консоль сыпется syntax error с первой строки, будто файл — не SQL;
  • скрипт проходит, но в конце десятки строк must be owner of или permission denied;
  • база создалась, а таблицы пустые.

Каждый вариант указывает на свою причину. Не пробуй «ещё раз, но с sudo» — сначала прочитай, что именно сказала команда.

Причина 1. Версии не совпадают (самая частая)

Ты снимал дамп локальным pg_dump, а сервер в облаке новее. Или наоборот — дамп сделан на новой версии, а разворачиваешь в старую.

Документация PostgreSQL описывает правило прямо: вывод pg_dump рассчитан на загрузку в серверы новее, чем сам pg_dump. Снимать дамп с более старого сервера тоже можно. А вот наоборот нельзя: pg_dump «не может снять дамп с серверов новее своей мажорной версии; он откажется даже пробовать, чтобы не рискнуть сделать негодный дамп».

Как проверить. Сравни две цифры:

pg_dump --version
psql -h твой-хост -U postgres -c "SHOW server_version;"

Как починить. Возьми инструмент версии не ниже сервера. На управляемых базах (Supabase, Neon, RDS) сервер обновляют без тебя, поэтому чаще всего устарел именно локальный клиент. Обнови его или сними дамп встроенным способом в панели провайдера.

И запомни направление: восстанавливать в версию новее — нормально, в старее — нет. Понижать версию базы дампом не получится.

Причина 2. Файл не того формата

pg_dump умеет отдавать четыре формата, и они не взаимозаменяемы. Обычный текстовый SQL — только один из них. Остальные три, как сказано в доках, «пригодны для подачи в pg_restore»: это custom, directory и tar.

Отсюда классика: дамп снят в формате custom (флаг -Fc), а разворачивают его через psql. Тот честно пытается прочитать бинарный файл как текст — и вываливает syntax error на первой строке.

Как проверить. Загляни в начало файла:

head -c 100 backup.dump

Видишь PGDMP и мусор — это архив, нужен pg_restore. Видишь -- PostgreSQL database dump и понятный SQL — это текст, нужен psql.

Как починить. Просто взять правильный инструмент:

# текстовый дамп
psql -d mydb -f backup.sql

# архив custom или directory
pg_restore -d mydb backup.dump

Обратной дороги нет только в одну сторону: из архива можно получить SQL (pg_restore -f out.sql), из текста архив — нет.

Причина 3. Ты не тот, кем был владелец

Скрипт доходит до конца, но половина команд отвалилась с must be owner of relation.

По умолчанию pg_dump вписывает в дамп команды смены владельца. Доки предупреждают: эти команды «упадут при запуске скрипта, если его запускает не суперпользователь (или не тот же пользователь, который владеет всеми объектами)».

На своей машине ты суперпользователь, и проблемы нет. На управляемой базе — нет: там у тебя обычная роль. Ролей postgres или admin_prod из старого дампа на новом сервере может вообще не существовать.

Как проверить. Поищи в дампе строки смены владельца:

grep -c "ALTER TABLE.*OWNER TO" backup.sql

Как починить. Сними дамп без владельцев и без прав доступа:

pg_dump -O -x -d mydb -f backup.sql

Флаг -O — тот самый, про который доки говорят: чтобы скрипт мог восстановить любой пользователь и стал владельцем всех объектов. Если дамп уже снят, те же ключи есть и у восстановления: pg_restore --no-owner --no-acl.

Ещё две мелочи, которые ловят реже

Расширения. Если в базе стоят расширения (pgvector, postgis), их установка требует прав, а сам объект в дамп не попадает целиком. Доки честно предупреждают: при выборочном дампе расширения «нет гарантии, что результат удастся восстановить в чистую базу самостоятельно». Лечение — заранее выполнить CREATE EXTENSION на новой базе.

Обрезанный файл. Дамп качали по сети, соединение оборвалось. Внешне файл на месте. Проверь размер и хвост: у текстового дампа последняя строка — комментарий о завершении. Нет её — файл неполный, и лечить нечего, нужен новый дамп.

Порядок таблиц важен? У меня ошибки про внешние ключи

При обычном восстановлении — нет: дамп сам расставляет объекты в правильном порядке, а ограничения добавляет после данных. Ошибки про внешние ключи обычно значат, что данные заливали выборочно, по одной таблице. Тогда либо соблюдай порядок «родители раньше детей», либо восстанавливай базу целиком.

Как убедиться, что бэкап рабочий, до аварии?

Единственный честный способ — разворачивать его. Заведи пустую тестовую базу, раз в месяц накатывай туда свежий дамп и делай пару запросов. Хорошо ставится задачей по расписанию.

Дамп восстановился, но данных за последний день нет

Значит, дамп старше, чем ты думал: он содержит состояние на момент снятия, а не на момент аварии. Разрыв между последним бэкапом и поломкой — это то, что ты теряешь. Уменьшается только частотой снятия — или журналами, которые управляемые базы ведут за тебя.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →