Как загрузить дамп PostgreSQL: восстановление базы из копии
Копия PostgreSQL загружается одной из двух программ. Текстовый файл .sql читает psql, архив из pg_dump -Fc — pg_restore. Перед загрузкой создайте пустую базу и пользователя, которому она принадлежала. После загрузки выполните ANALYZE, чтобы база собрала статистику для запросов.
Содержание 10
Что сделать прямо сейчас
Здесь — как загрузить копию shop.dump, сделанную командой pg_dump -Fc (как её сделать), в новую базу shop. Вместо shop и ivan — имена своей базы и пользователя сайта.
- Подключитесь к серверу по SSH (как подключиться) и положите файл копии в папку ~/backup. Как отправить файл на сервер — в статье Команда scp.
- Если на этом сервере ещё нет пользователя ivan, создайте его — как создать пользователя. Если вы сохранили пользователей файлом polzovateli.sql, загрузите его:
sudo -u postgres psql -X < ~/backup/polzovateli.sql. СтрокуERROR: role "postgres" already existsможно не замечать: этот пользователь уже есть, остальные создадутся. - Создайте пустую базу, владелец — ivan:
sudo -u postgres createdb -O ivan -T template0 shop- Загрузите копию:
sudo -u postgres pg_restore -d shop < ~/backup/shop.dumpЕсли команда ничего не написала и снова появилась строка для ввода, копия загружена без ошибок.
- Соберите статистику, чтобы запросы сразу работали быстро:
sudo -u postgres psql -d shop -c 'ANALYZE;'- Проверьте, что таблицы на месте:
sudo -u postgres psql -d shop -c '\dt'.
Файл подаётся через знак <, а не путём после команды: пользователь postgres не может читать вашу домашнюю папку, а так файл открывает ваш пользователь.
Какой у вас файл
Посмотрите первые пять символов файла:
head -c 5 ~/backup/shop.dump; echo| Что видите | Что это за файл | Чем загружать |
|---|---|---|
PGDMP | архив pg_dump: -Fc | pg_restore |
-- и дальше текст | текстовый дамп с командами SQL | psql |
| непонятные символы, имя кончается на .gz | сжатый текстовый дамп | zcat и psql |
| это папка, в ней файл toc.dat | архив-папка pg_dump: -Fd | pg_restore |
| имя кончается на .tar | архив tar pg_dump: -Ft | pg_restore |
Если подать текстовый файл в pg_restore, он ответит input file appears to be a text format dump. Please use psql.
Текстовый дамп .sql
sudo -u postgres createdb -O ivan -T template0 shop
sudo -u postgres psql -X -d shop --set ON_ERROR_STOP=on < ~/backup/shop.sqlСжатый дамп .sql.gz:
zcat ~/backup/shop.sql.gz | sudo -u postgres psql -X -d shop --set ON_ERROR_STOP=on-X— не читать личный файл настроек psql ~/.psqlrc, чтобы он не помешал загрузке.--set ON_ERROR_STOP=on— остановиться на первой ошибке. Без этого psql продолжит загрузку после ошибки, и база загрузится не вся.- Добавьте
-1, чтобы загрузить всё одной транзакцией: при любой ошибке база останется пустой, а не загруженной наполовину.
psql выводит на экран ответы на команды из файла: SET, CREATE TABLE, ALTER TABLE, COPY 1520. Число после COPY — сколько строк загружено в таблицу.
Дамп, который сделан командой pg_dumpall, загружается в базу postgres: sudo -u postgres psql -X -d postgres < ~/backup/vse-bazy.sql. Базы из него создадутся сами.
Архив pg_dump: ключи pg_restore
| Ключ | Что делает |
|---|---|
-d shop | в какую базу загружать |
--clean --if-exists | перед загрузкой удалить в базе то, что есть в копии, — чтобы залить копию поверх старой базы |
-C -d postgres | создать базу с именем из копии и загрузить в неё |
--no-owner | не переносить владельцев таблиц из копии |
--role=ivan | загружать от имени ivan: таблицы будут принадлежать ему |
--no-acl | не переносить права GRANT из копии |
-e | остановиться на первой ошибке |
-1 | всё одной транзакцией: либо загрузится вся копия, либо ничего |
-j 2 | загружать несколько таблиц одновременно |
-t orders | только таблицу orders |
-l | ничего не загружать, показать содержимое копии |
Без -e pg_restore продолжает работу после ошибок и в конце пишет, сколько их было: errors ignored on restore: 3. Сами ошибки — строками выше.
Таблица, загруженная ключом -t, приходит без своих индексов: pg_restore берёт только её саму. Чтобы достать из копии одну таблицу, не трогая рабочую базу, загрузите копию целиком в отдельную базу, например shop_kopiya, и смотрите нужные строки там.
Загрузить копию поверх старой базы
--clean удаляет таблицы базы, которые есть в копии, вместе с данными. Всё, что записано в них после копии, пропадёт. Сначала сделайте свежую копию текущей базы: sudo -u postgres pg_dump -Fc shop > ~/backup/shop-do-vosstanovleniya.dump.sudo -u postgres pg_restore --clean --if-exists -d shop < ~/backup/shop.dump--if-existsнужен, чтобы pg_restore не ругался на таблицы, которых в базе уже нет.- Таблицы, которых нет в копии, останутся в базе как были.
Чтобы база стала точно такой, как в копии, удалите её и создайте заново: как удалить базу, затем шаги 3–5 из начала страницы. Перед этим остановите сайт: база не удалится, пока к ней подключены.
Перенос на другой сервер
На новом сервере пользователь сайта может называться иначе, чем на старом. Тогда владельцев из копии переносить не нужно — загрузите копию от имени нового пользователя:
sudo -u postgres createdb -O ivan -T template0 shop
sudo -u postgres pg_restore --no-owner --no-acl --role=ivan -d shop < ~/backup/shop.dump--no-owner— не назначать владельцев из копии: со старого сервера они могли не переехать.--role=ivan— pg_restore загружает копию от имени ivan, и все таблицы принадлежат ему. Сайт под ivan сможет читать и менять их без отдельных GRANT.--no-acl— не переносить права со старого сервера: если в них упомянуты пользователи, которых здесь нет, будут ошибки.
С текстовым дампом так не получится: команды владельцев записаны прямо в файл. Если на новом сервере нет пользователей со старыми именами, создайте их или загрузите polzovateli.sql из pg_dumpall --globals-only. В следующий раз делайте копию с ключами pg_dump --no-owner --no-acl.
Копию, сделанную pg_dump версии 16, можно загрузить и в более новый PostgreSQL. В обратную сторону, в более старый, загрузка не гарантирована.
Большая база: загрузка в несколько потоков
Ключ -j не работает с файлом, поданным через <: pg_restore ответит parallel restore from standard input is not supported. Ему нужен сам файл. Переложите копию в домашнюю папку пользователя postgres:
sudo cp ~/backup/shop.dump /var/lib/postgresql/
sudo chown postgres:postgres /var/lib/postgresql/shop.dump
sudo -u postgres pg_restore -j 2 -d shop /var/lib/postgresql/shop.dumpДокументация PostgreSQL советует начинать с числа ядер сервера — сколько их, покажет nproc. Каждый поток — отдельное подключение к базе. Ключи -j и -1 вместе не работают.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
input file appears to be a text format dump. Please use psql. | в pg_restore подали текстовый дамп | загрузите через psql, как выше |
ERROR: role "olga" does not exist | на сервере нет пользователя, которому принадлежали таблицы в копии | создайте его, загрузите polzovateli.sql или загружайте с --no-owner --role=ivan |
ERROR: relation "orders" already exists | в базе уже есть такие таблицы | загружайте в пустую базу или с --clean --if-exists |
errors ignored on restore: 3 | часть команд не выполнилась | найдите строки ERROR выше, исправьте причину и загрузите копию в чистую базу снова |
FATAL: database "shop" does not exist | база не создана | sudo -u postgres createdb -O ivan -T template0 shop; разбор ошибки |
unsupported version (1.16) in file header | копия сделана более новой версией pg_dump, например 17, а pg_restore — версии 16 | загружайте pg_restore той же версии, что и pg_dump, или новее |
invalid command \restrict | psql старее, чем pg_dump, которым сделан дамп | обновите пакеты PostgreSQL: sudo apt update && sudo apt upgrade |
permission denied for schema public | загрузка идёт от пользователя, у которого нет прав на схему | сделайте его владельцем базы: createdb -O; разбор ошибки |
parallel restore from standard input is not supported | ключ -j с файлом через < | укажите путь к файлу, как выше |
parallel restore is not supported with this archive file format | ключ -j с архивом tar | для -j нужен архив -Fc или -Fd |
Всё сверено с PostgreSQL 16 — эта версия ставится в Ubuntu 24.04.
Источники
- PostgreSQL 16: pg_restore — на английском: ключи -d, -C, --clean, --if-exists, --no-owner, --role, --no-acl, -e, -1, -j, -t и -l, ANALYZE после загрузки, пустая база из template0.
- PostgreSQL 16: SQL Dump — на английском: загрузка текстового дампа через psql -X, ON_ERROR_STOP, -1, пользователи должны существовать заранее, загрузка pg_dumpall.
- PostgreSQL 16: pg_dump — на английском: --no-owner и --no-acl для текстового дампа, загрузка в более новые версии.
- PostgreSQL 16: psql — на английском: ключи -X, -1, переменная ON_ERROR_STOP.
- Исходный код PostgreSQL 16: pg_backup_archiver.c — подпись PGDMP в начале архива, тексты appears to be a text format dump, unsupported version in file header, parallel restore is not supported.
- Исходный код PostgreSQL 16: pg_backup_custom.c — текст parallel restore from standard input is not supported.
- Исходный код PostgreSQL 17: pg_backup_archiver.h — pg_dump 17 пишет архив версии 1.16, pg_restore 16 читает до 1.15.
- Исходный код PostgreSQL 16: pg_restore.c — текст errors ignored on restore.
- Исходный код PostgreSQL 16: heap.c — текст relation already exists.
- Исходный код PostgreSQL 16: user.c — текст role already exists.
- Исходный код PostgreSQL 16: command.c — команда \restrict и текст invalid command.
Сверено 5 ноября 2026 года.
Что почитать дальше
- pg_dumpкак сделать копию и настроить её каждую ночь.
- Создать и удалить базуcreatedb, dropdb и владелец базы.
- Создать пользователяесли на новом сервере нет пользователя сайта.
- Список баз и таблицкак проверить, что всё загрузилось.