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

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

pg_dump сохраняет одну базу PostgreSQL в файл. Команда sudo -u postgres pg_dump -Fc shop > shop.dump делает сжатую копию базы shop, а загружает её обратно pg_restore. Сайт во время копии работает: pg_dump не мешает читать и записывать данные. Пользователей и их пароли pg_dump не сохраняет — для них есть pg_dumpall --globals-only.

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

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

  1. Подключитесь к серверу по SSH (как подключиться). Команды ниже вводятся в консоли сервера, не в консоли базы.
  2. Создайте папку для копий и закройте её от других пользователей сервера:
mkdir -p ~/backup && chmod 700 ~/backup
  1. Сделайте копию базы. Вместо shop — имя своей базы (как посмотреть список баз):
sudo -u postgres pg_dump -Fc shop > ~/backup/shop.dump

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

  1. Проверьте, что в файле есть таблицы:
pg_restore -l ~/backup/shop.dump | grep 'TABLE DATA'

Каждая строка ответа — одна таблица с данными. Пустой ответ значит, что таблиц в базе нет или копия не удалась.

  1. Скачайте файл к себе на компьютер: копия на том же сервере пропадёт вместе с ним. Как скачать — в статье Команда scp.

Пока идёт копия, сайт работает: pg_dump не блокирует чтение и запись. В файл попадает база в том виде, в каком она была в момент запуска команды. Ждать конца копии будут только команды, которым нужна исключительная блокировка таблицы, например ALTER TABLE.

Какой формат выбрать

КлючЧто получитсяЧем загружать обратно
без ключа или -Fpтекстовый файл с командами SQLpsql
-Fcодин сжатый файлpg_restore; можно загрузить отдельные таблицы
-Fd -f папкапапка, в ней по сжатому файлу на таблицуpg_restore; можно загружать в несколько потоков
-Ftархив tar без сжатияpg_restore

Для копий на каждый день подойдёт -Fc: файл сжат, а из него можно достать одну таблицу, не загружая всю базу.

Текстовый файл нужен, если вы хотите прочитать или поправить команды руками. Сразу сжатым:

sudo -u postgres pg_dump shop | gzip > ~/backup/shop.sql.gz

Проверить, что текстовая копия записалась целиком: zcat ~/backup/shop.sql.gz | grep 'dump complete'. В конце целой копии есть строка -- PostgreSQL database dump complete. Если её нет, копия оборвалась.

Как загрузить копию каждого формата — на странице Как загрузить дамп PostgreSQL.

Пользователи и пароли — отдельной командой

pg_dump сохраняет таблицы, данные и права внутри одной базы, но не самих пользователей: они общие для всех баз сервера. Если базу придётся поднимать на новом сервере, пользователя сайта там не будет. Сохраните пользователей отдельно:

sudo -u postgres pg_dumpall --globals-only > ~/backup/polzovateli.sql

В файле — команды CREATE ROLE и пароли пользователей в виде хешей. Храните его так же бережно, как копию базы.

Все базы сервера и пользователей одним текстовым файлом сохраняет sudo -u postgres pg_dumpall > ~/backup/vse-bazy.sql. Такой файл загружается только целиком через psql, поэтому для одной базы удобнее pg_dump.

Одна таблица или копия без лишнего

КомандаЧто сохранит
sudo -u postgres pg_dump -Fc -t orders shop > ~/backup/orders.dumpтолько таблицу orders
sudo -u postgres pg_dump -Fc -T 'log_*' shop > ~/backup/shop.dumpвсю базу без таблиц, имя которых начинается с log_
sudo -u postgres pg_dump -Fc --exclude-table-data=logs shop > ~/backup/shop.dumpвсю базу; у таблицы logs — только структура, без строк
sudo -u postgres pg_dump -s shop > ~/backup/shop-struktura.sqlтолько структуру: таблицы, индексы, без данных
sudo -u postgres pg_dump -Fc -n app shop > ~/backup/app.dumpтолько схему app

Ключи -t и -T можно повторять: -t orders -t users. Имя с заглавными буквами пишите в двух парах кавычек: -t '"Orders"'.

Копия одной таблицы может не загрузиться в пустую базу сама по себе: pg_dump не добавляет в неё то, от чего таблица зависит, например другие таблицы, на которые она ссылается.

Большая база: копия в несколько потоков

Формат-папка позволяет сохранять несколько таблиц одновременно. Папку создаёт сам pg_dump, её не должно быть заранее, и писать в неё будет пользователь postgres, поэтому путь — в его домашней папке:

sudo -u postgres pg_dump -Fd -j 2 -f /var/lib/postgresql/shop-kopiya shop
  • -j 2 — сколько таблиц сохранять одновременно. Каждый поток нагружает процессор и диск; сколько у сервера ядер, покажет nproc.
  • pg_dump откроет -j + 1 подключений к базе. Если мест мало, сайт может их не получить — как посмотреть предел.
  • Несколько потоков сильнее нагружают сервер. На VPS с одним-двумя ядрами запускайте такую копию ночью.

Копия каждую ночь по расписанию

  1. Создайте папку для ночных копий в домашней папке пользователя postgres:
sudo -u postgres mkdir -p /var/lib/postgresql/backup
  1. Откройте расписание пользователя postgres:
sudo crontab -u postgres -e

Если crontab спросит, в каком редакторе открыть файл, выберите nano — подробнее.

  1. Впишите в конец две строки:
30 3 * * * pg_dump -Fc shop > /var/lib/postgresql/backup/shop-$(date +\%F).dump
0 4 * * * find /var/lib/postgresql/backup -name 'shop-*.dump' -mtime +14 -delete

Первая в 3:30 ночи делает копию с датой в имени файла: shop-2026-11-05.dump. Вторая в 4:00 удаляет копии старше 14 дней. Знак % в расписании пишется с обратной косой чертой — почему.

  1. Сохраните (Ctrl+O, Enter, Ctrl+X). На следующее утро проверьте, что копия появилась: sudo ls -lh /var/lib/postgresql/backup/.

Время в расписании — по часовому поясу сервера. Как устроены строки расписания, разобрано в статье Cron в Linux.

Где хранить копии

Копия на том же сервере не поможет, если сервер сломается или его удалят. Держите хотя бы одну свежую копию в другом месте: на своём компьютере или во внешнем хранилище, например в S3-хранилище Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как отправлять туда копии по расписанию, разобрано в статье Резервные копии сайта.

Раз в месяц пробуйте загрузить копию в пустую базу. Только так видно, что из неё можно восстановиться, — пошагово на странице Как загрузить дамп PostgreSQL.

Копия под пользователем сайта или с другого сервера

pg_dump можно запустить и не от postgres, а от пользователя сайта, например если база стоит на другом сервере:

pg_dump -h 127.0.0.1 -U ivan -Fc shop > ~/backup/shop.dump
  • pg_dump спросит пароль пользователя ivan.
  • Вместо 127.0.0.1 — адрес сервера базы, если она стоит не здесь.
  • Пользователю нужно право читать все таблицы базы. Если хотя бы одну он прочитать не может, pg_dump остановится с ошибкой — как дать права.

pg_dump сохраняет базу того же или более старого выпуска PostgreSQL. pg_dump 16 из Ubuntu 24.04 откажется сохранять базу на PostgreSQL 17.

Ошибки и как их исправить

Что видитеПричинаЧто делать
FATAL: role "ubuntu" does not existpg_dump запущен без sudo -u postgres, и он вошёл под именем вашего пользователя Linuxдобавьте sudo -u postgres перед pg_dump; разбор ошибки
FATAL: database "shop" does not existбазы с таким именем нетимя — по списку sudo -u postgres psql -l; разбор ошибки
query failed: ERROR: permission denied for table ordersпользователь, под которым запущен pg_dump, не может читать таблицузапустите от postgres или дайте права
no matching tables were foundв ключе -t нет таблицы с таким именемпроверьте имя: \dt *.orders в psql; имя с заглавными буквами — в кавычках
parallel backup only supported by the directory formatключ -j без -Fdдобавьте -Fd -f папка
could not open output file "…"пользователь postgres не может писать в эту папкуукажите папку в /var/lib/postgresql или пишите файл через >, как в начале страницы
aborting because of server version mismatchбаза новее, чем pg_dumpвозьмите pg_dump той же версии, что и база: версии новее 16 есть в репозитории apt.postgresql.org

Всё сверено с PostgreSQL 16 — эта версия ставится в Ubuntu 24.04.

Источники

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

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

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