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.
Содержание 11
- Что сделать прямо сейчас
- Какой формат выбрать
- Пользователи и пароли — отдельной командой
- Одна таблица или копия без лишнего
- Большая база: копия в несколько потоков
- Копия каждую ночь по расписанию
- Где хранить копии
- Копия под пользователем сайта или с другого сервера
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться). Команды ниже вводятся в консоли сервера, не в консоли базы.
- Создайте папку для копий и закройте её от других пользователей сервера:
mkdir -p ~/backup && chmod 700 ~/backup- Сделайте копию базы. Вместо shop — имя своей базы (как посмотреть список баз):
sudo -u postgres pg_dump -Fc shop > ~/backup/shop.dumpЕсли команда ничего не написала и снова появилась строка для ввода, копия готова.
- Проверьте, что в файле есть таблицы:
pg_restore -l ~/backup/shop.dump | grep 'TABLE DATA'Каждая строка ответа — одна таблица с данными. Пустой ответ значит, что таблиц в базе нет или копия не удалась.
- Скачайте файл к себе на компьютер: копия на том же сервере пропадёт вместе с ним. Как скачать — в статье Команда scp.
Пока идёт копия, сайт работает: pg_dump не блокирует чтение и запись. В файл попадает база в том виде, в каком она была в момент запуска команды. Ждать конца копии будут только команды, которым нужна исключительная блокировка таблицы, например ALTER TABLE.
Какой формат выбрать
| Ключ | Что получится | Чем загружать обратно |
|---|---|---|
без ключа или -Fp | текстовый файл с командами SQL | psql |
-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 с одним-двумя ядрами запускайте такую копию ночью.
Копия каждую ночь по расписанию
- Создайте папку для ночных копий в домашней папке пользователя postgres:
sudo -u postgres mkdir -p /var/lib/postgresql/backup- Откройте расписание пользователя postgres:
sudo crontab -u postgres -eЕсли crontab спросит, в каком редакторе открыть файл, выберите nano — подробнее.
- Впишите в конец две строки:
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 дней. Знак % в расписании пишется с обратной косой чертой — почему.
- Сохраните (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 exist | pg_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.
Источники
- PostgreSQL 16: pg_dump — на английском: форматы -Fp, -Fc, -Fd, -Ft, ключи -t, -T, -n, -s, --exclude-table-data, -j и число подключений, сжатие по умолчанию, работа без блокировки.
- PostgreSQL 16: SQL Dump — на английском: копия на момент запуска, роли не входят в pg_dump, pg_dumpall --globals-only.
- PostgreSQL 16: pg_dumpall — на английском: --globals-only и пароли пользователей в копии.
- PostgreSQL 16: pg_restore — на английском: ключ -l, список содержимого копии.
- Исходный код PostgreSQL 16: pg_dump.c — тексты no matching tables were found и parallel backup only supported by the directory format.
- Исходный код PostgreSQL 16: pg_backup_db.c — тексты query failed и aborting because of server version mismatch.
- Исходный код PostgreSQL 16: pg_backup_archiver.c — строка PostgreSQL database dump complete и текст could not open output file.
Сверено 5 ноября 2026 года.
Что почитать дальше
- Как загрузить дамп PostgreSQLкак восстановить базу из копии.
- Резервные копии сайтакак сохранять не только базу, но и файлы сайта.
- Список баз и таблицкак узнать имя базы и размер таблиц.
- mysqldumpто же для MySQL и MariaDB.