Поиск
Справочник

Как загрузить дамп PostgreSQL: восстановление базы из копии

Копия PostgreSQL загружается одной из двух программ. Текстовый файл .sql читает psql, архив из pg_dump -Fc — pg_restore. Перед загрузкой создайте пустую базу и пользователя, которому она принадлежала. После загрузки выполните ANALYZE, чтобы база собрала статистику для запросов.

≈ 9 мин чтения
Содержание 10

Что сделать прямо сейчас

Здесь — как загрузить копию shop.dump, сделанную командой pg_dump -Fc (как её сделать), в новую базу shop. Вместо shop и ivan — имена своей базы и пользователя сайта.

  1. Подключитесь к серверу по SSH (как подключиться) и положите файл копии в папку ~/backup. Как отправить файл на сервер — в статье Команда scp.
  2. Если на этом сервере ещё нет пользователя ivan, создайте его — как создать пользователя. Если вы сохранили пользователей файлом polzovateli.sql, загрузите его: sudo -u postgres psql -X < ~/backup/polzovateli.sql. Строку ERROR: role "postgres" already exists можно не замечать: этот пользователь уже есть, остальные создадутся.
  3. Создайте пустую базу, владелец — ivan:
sudo -u postgres createdb -O ivan -T template0 shop
  1. Загрузите копию:
sudo -u postgres pg_restore -d shop < ~/backup/shop.dump

Если команда ничего не написала и снова появилась строка для ввода, копия загружена без ошибок.

  1. Соберите статистику, чтобы запросы сразу работали быстро:
sudo -u postgres psql -d shop -c 'ANALYZE;'
  1. Проверьте, что таблицы на месте: sudo -u postgres psql -d shop -c '\dt'.

Файл подаётся через знак <, а не путём после команды: пользователь postgres не может читать вашу домашнюю папку, а так файл открывает ваш пользователь.

Какой у вас файл

Посмотрите первые пять символов файла:

head -c 5 ~/backup/shop.dump; echo
Что видитеЧто это за файлЧем загружать
PGDMPархив pg_dump: -Fcpg_restore
-- и дальше тексттекстовый дамп с командами SQLpsql
непонятные символы, имя кончается на .gzсжатый текстовый дампzcat и psql
это папка, в ней файл toc.datархив-папка pg_dump: -Fdpg_restore
имя кончается на .tarархив tar pg_dump: -Ftpg_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 \restrictpsql старее, чем 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.

Источники

Сверено 5 ноября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше