Проверка и восстановление дампа PostgreSQL

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

Материал посвящён теме «Проверка и восстановление дампа PostgreSQL» с акцентом на диагностике и локализации ошибок.

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

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

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

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

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

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

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

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

Резервная точка

Сохраните именно те файлы и параметры, которые собираетесь менять.

TS=$(date +%F-%H%M%S)
mkdir -p /root/iiadmin-change-$TS
cp -a /path/to/config /root/iiadmin-change-$TS/
systemctl status SERVICE --no-pager > /root/iiadmin-change-$TS/status-before.txt
ss -lntup > /root/iiadmin-change-$TS/listeners-before.txt

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 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

В этой статье рассматривается именно задача «Проверка и восстановление дампа PostgreSQL», а не полная установка всех компонентов категории «PostgreSQL». Перед началом перечислите файлы, процессы, порты и внешние зависимости, которые реально входят в изменение.

Успешный результат должен быть проверяемым: конфигурация проходит штатный тест, нужный процесс работает, listener находится на ожидаемом интерфейсе, а реальный клиент получает правильный ответ. Всё, что не влияет на эти критерии, лучше вынести в отдельное изменение.

Целостность и политика хранения

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

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

Локализация уровня отказа

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

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

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

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

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

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

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

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

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

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

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

Финальная проверка с точки зрения реального клиента

Последнюю проверку темы «Проверка и восстановление дампа PostgreSQL» выполняйте тем же способом, которым сервисом будет пользоваться человек или приложение: с нужным доменом, протоколом, учётной записью и внешней сетью. Локальная команда остаётся диагностическим этапом, но не заменяет прохождение всей цепочки.

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

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

Точная фиксация симптома

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

Отделяйте постоянную ошибку от периодической: повторите один и тот же тест несколько раз и сравните условия появления.

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

Формат 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