Резервная копия PostgreSQL с помощью pg_dump

Задача и общий подход

Материал посвящён теме «Резервная копия PostgreSQL с помощью pg_dump» с акцентом на первичной установке и минимальной рабочей конфигурации.

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

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

Что должно получиться

После выполнения руководства по теме «Резервная копия PostgreSQL с помощью pg_dump» результат должен быть измеримым:

• сохранить резервную точку и понятный сценарий отката
• зафиксировать логи и признаки успешного запуска
• получить воспроизводимую конфигурацию, проверяемую командами
• оставить наружу только необходимые интерфейсы и порты

Когда применять этот порядок

Этот сценарий подходит для следующих ситуаций:

• плановое внедрение или перенос компонента категории «PostgreSQL» на новый VPS
• изменение портов, домена, сертификата, маршрута или способа публикации сервиса
• разбор инцидента, когда локальная и внешняя проверки дают разные результаты
• подготовка к обновлению пакета или восстановлению после неудачного изменения

Подготовка перед изменениями

Подготовительный этап снижает риск потерять доступ и смешать несколько причин одной неисправности.

• Сохраните копии изменяемых файлов с датой и временем.
• Откройте вторую административную сессию и не закрывайте текущую.
• Зафиксируйте текущие порты, процессы и состояние службы.
• Проверьте свободное место, DNS и системное время.
• Подготовьте команду отката до применения изменений.

Пошаговая настройка

Выполняйте блоки последовательно и после каждого шага проверяйте код возврата команды.

sudo -u postgres pg_dump -Fc -d appdb -f /var/backups/appdb-$(date +%F).dump

pg_restore -l /var/backups/appdb-YYYY-MM-DD.dump | head -n 50

sudo -u postgres pg_dumpall --globals-only > /var/backups/postgres-globals-$(date +%F).sql

sudo -u postgres createdb appdb_restore_test
sudo -u postgres pg_restore -d appdb_restore_test /var/backups/appdb-YYYY-MM-DD.dump

systemctl status postgresql --no-pager
df -h /var/lib/postgresql /var/backups

Имена доменов, адреса, порты и пути в примерах условные. Перед выполнением замените их фактическими значениями.

Проверка результата

Проверка должна охватывать конфигурацию, процесс, listener и реальный запрос.

• дамп с кодом 0
• pg_restore читает архив
• сохранены роли
• тестовое восстановление успешно
• копия вынесена наружу

systemctl is-active SERVICE
systemctl status SERVICE --no-pager
journalctl -u SERVICE -n 80 --no-pager
ss -lntup

Диагностика, если не заработало

Диагностика строится как последовательное исключение уровней, а не случайный набор перезапусков.

1. Подтвердите симптом точной командой и запишите время.
2. Проверьте конфигурацию штатным тестом.
3. Проверьте процесс и последние записи журнала.
4. Убедитесь, что нужный адрес и порт слушаются.
5. Сравните локальный запрос с запросом извне.
6. Только затем проверяйте firewall, DNS и маршрут.
7. Меняйте одну переменную и повторяйте тот же тест.

Для темы «Резервная копия PostgreSQL с помощью pg_dump» важно не путать открытый firewall с запущенным сервисом: правило доступа не создаёт listener, а активный процесс не гарантирует доступность извне.

Как устроена схема

pg_dump создаёт логический снимок одной базы, pg_dumpall сохраняет глобальные объекты, pg_basebackup — физическую копию кластера. WAL нужен для восстановления к моменту времени.

Важно разделять конфигурацию, процесс, сетевой сокет и внешний запрос. Успех на одном уровне не доказывает исправность следующего.

Безопасность

После получения рабочего результата уменьшите количество исключений и временных разрешений.

• просматривайте журналы аутентификации и ошибки запуска
• ограничивайте административный доступ доверенными IP или VPN
• выдавайте файлам конфигурации минимальные права
• не храните секреты в публикуемых конфигурациях и журналах
• используйте принцип минимально необходимых прав

Дальнейшее сопровождение

Рабочая конфигурация со временем устаревает и требует контроля.

• проверяйте журналы ошибок и их размер
• контролируйте таймеры, сертификаты и автоматические задания
• после обновления повторяйте тест конфигурации и портов
• храните резервную копию вне VPS
• документируйте нестандартные пути и зависимости

Типичные ошибки

Чаще всего восстановление усложняют следующие действия:

• перезапуск службы до проверки синтаксиса
• проверка только локального подключения без внешнего теста
• открытие административного порта для всего интернета
• использование устаревшей команды без проверки версии пакета
• игнорирование различий правил IPv4 и IPv6
• удаление рабочей конфигурации до успешного запуска новой

Откат изменений

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

1. не восстанавливать поверх рабочей базы
2. создать тестовую базу
3. сравнить объекты
4. переключать приложение после проверки
5. сохранить исходный кластер

Не удаляйте неудачную конфигурацию до выяснения причины: она полезна для diff и разбора инцидента.

Контрольный список

Перед тем как считать тему «Резервная копия PostgreSQL с помощью pg_dump» закрытой, пройдите список:

Что дополнительно сверить в документации

При подготовке материала были сопоставлены разделы русскоязычной документации. Для углублённой проверки полезно изучить:

• 25.3. Непрерывное архивирование и восстановление на момент времени (Point-in-Time Recovery, PITR) #
• Примечание
• 25.3.1. Настройка архивирования WAL #
• 25.3.2. Создание базовой резервной копии #
• 25.3.3. Создание инкрементальной резервной копии #
• 25.3.4. Создание базовой резервной копии через низкоуровневый API #
• 25.3.5. Восстановление непрерывной архивной копии #
• 25.3.6. Линии времени #

Данные, которые нужно сохранить до изменения

Перед работой по теме «Резервная копия PostgreSQL с помощью pg_dump» сохраните состояние именно тех компонентов, которые участвуют в схеме: активную конфигурацию, статус процесса, открытые порты, последние ошибки и результат контрольного запроса. Этот набор позволит отличить последствия новой правки от ранее существовавшего поведения.

Полезно хранить вывод в одном каталоге с временной меткой и коротким README. При разборе инцидента это быстрее, чем повторно собирать сведения после нескольких перезапусков.

pg_restore -l /var/backups/appdb-YYYY-MM-DD.dump | head -n 50

Повторная проверка после restart или перезагрузки

Часть настроек работает только в текущем процессе или до следующего reload. После успешного первичного теста повторите проверку после штатного restart, а для критичной инфраструктуры — после плановой перезагрузки сервера в окно работ.

Сравните автозапуск, владельцев файлов, постоянные правила firewall, DNS и фактический listener. Это выявляет зависимость от ручной команды, временного файла или правила, которое не сохраняется.

sudo -u postgres pg_dumpall --globals-only > /var/backups/postgres-globals-$(date +%F).sql

Контрольные точки именно для этой темы

Для темы «Резервная копия PostgreSQL с помощью pg_dump» заранее запишите исходные значения и ожидаемый результат. Это позволяет повторить один и тот же тест до изменения, после применения и после возможного отката.

Не считайте задачу завершённой по одному зелёному статусу. Проверка должна охватывать конфигурацию, процесс, сетевой уровень, журнал и прикладной ответ.

• дамп с кодом 0
• pg_restore читает архив
• сохранены роли
• тестовое восстановление успешно
• копия вынесена наружу

sudo -u postgres pg_dump -Fc -d appdb -f /var/backups/appdb-$(date +%F).dump

Дамп и контрольное восстановление

Формат custom удобен для pg_restore, выборочного восстановления и параллельной загрузки. После создания проверьте список объектов и разверните копию в отдельную тестовую базу.

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

sudo -u postgres pg_dump -Fc DBNAME > DBNAME.dump
pg_restore -l DBNAME.dump | head -n 60
createdb DBNAME_restore_test
pg_restore -d DBNAME_restore_test DBNAME.dump

Источники и документация

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

• Компания Postgres Professional
• Компания Postgres Professional
• Компания Postgres Professional
• Компания Postgres Professional