بازیابی PostgreSQL تا پیش از حذف داده؛ تمرین با pgBackRest

PostgreSQL نسخهٔ ۱۸ و pgBackRest باید از قبل روی مبدأ آزمایشی و میزبان جداگانهٔ بازیابی نصب باشند. مخزن رسمی PGDG برای Ubuntu نسخه‌های ۲۶٫۱۰ و ۲۶٫۰۴ و Debian نسخه‌های ۱۳ و ۱۲ بسته دارد؛ مسیر باینری‌ها /usr/lib/postgresql/18/bin و نام بسته‌ها postgresql-18 و postgresql-client-18 است. در نسخه‌های فرعیِ تحت پشتیبانی RHEL، Rocky Linux و AlmaLinux از شاخه‌های ۹ و ۱۰، بسته‌های PGDG با نام postgresql18-server و postgresql18 و مسیر /usr/pgsql-18/bin عرضه می‌شوند. انتخاب خانوادهٔ Red Hat، مسیر نسخهٔ بازیابی‌شده را به /var/lib/pgsql/academy-pitr-20261028 تغییر می‌دهد؛ هیچ کلاستر یا سرویس موجودی انتخاب یا مقداردهی اولیه نمی‌شود. مخازن PGDG مخصوص RHEL 9.6 و 10.0 بازنشسته شده‌اند؛ از نسخهٔ فرعیِ همچنان تحت پشتیبانی استفاده کنید.

این مسیرها از مستندات استخراج شده‌اند و آزمون عملی سازگاری محسوب نمی‌شوند. ابتدا /etc/os-release و نسخهٔ دقیق محصول را بررسی کنید. حساب‌ها، دسترسی شبکه و اعتبارنامه‌های محافظت‌شده باید از قبل آماده باشند. برای آماده‌کردن ابزارها، سرویس موجود را دوباره راه‌اندازی نکنید، دیتابیس تازه مقداردهی اولیه نکنید، پورتی روی فایروال باز نکنید و Python سیستم را تغییر ندهید.

محدودیت مهم: این تمرین فقط کلاستر آزمایشی با postgresql.conf، pg_hba.conf و pg_ident.conf داخل پوشهٔ داده را می‌پذیرد. کلاستر پیش‌فرض بسته‌های Debian و Ubuntu که تنظیماتش بیرون این پوشه است، با تغییر مسیر باینری سازگار نمی‌شود و در این راهنما پوشش داده نشده است. بررسی گام بعد باید این شرط را پیش از ساخت دادهٔ آزمایشی تأیید کند.

این بررسی را روی هر دو میزبان مبدأ آزمایشی و بازیابی، با حساب PostgreSQL انجام دهید؛ رایانهٔ مدیریتِ فاقد ابزار سرور محل اجرای آن نیست.

cat /etc/os-release
id
test -x /usr/lib/postgresql/18/bin/psql
/usr/lib/postgresql/18/bin/psql --version
test -x /usr/lib/postgresql/18/bin/pg_ctl
/usr/lib/postgresql/18/bin/pg_ctl --version
pgbackrest version
getent passwd postgres

با کاربر سیستم‌عامل PostgreSQL روی میزبان مبدأ اجرا کنید. نسخه، شناسهٔ کلاستر و محل واقعی فایل‌های تنظیمات را با مخزن تطبیق دهید. وجود یک دیتابیس با نام مشابه کافی نیست؛ شناسهٔ کلاستر باید همان باشد که مخزن برای آن بکاپ دارد. بررسی مسیرها، کلاستر دارای تنظیمات بیرونی را پیش از ایجاد دادهٔ آزمایشی متوقف می‌کند.

فرمان check آرشیو را بررسی می‌کند و ممکن است برای این کار رکورد WAL بسازد؛ بنابراین کاملاً فقط‌خواندنی نیست. اگر آرشیو خاموش است یا check خطا دارد، ابتدا مشکل بکاپ را برطرف کنید. برای ادامه‌دادن تمرین، برنامهٔ نگه‌داری بکاپ‌ها را تغییر ندهید. نام‌های قابل‌تنظیم این مثال فقط حروف کوچک لاتین، عدد و زیرخط را با آغاز حرف می‌پذیرند و حداکثر۳۲کاراکترند.

for value in 'academy_lab' 'academy_pitr_probe' 'academy_before_change' 'academy'; do
  printf '%s\n' "$value" | grep -Eq '^[a-z][a-z0-9_]{0,31}$' || exit 1
done
'/usr/lib/postgresql/18/bin/psql' -X -v ON_ERROR_STOP=1 -d 'academy_lab' -c "SELECT version(); SELECT system_identifier FROM pg_control_system(); SHOW data_directory; SHOW config_file; SHOW hba_file; SHOW ident_file; SHOW archive_mode; SHOW archive_command;"
pgbackrest --stanza='academy' check
pgbackrest --stanza='academy' info
data_dir=$('/usr/lib/postgresql/18/bin/psql' -X -At -d 'academy_lab' -c 'SHOW data_directory')
config=$('/usr/lib/postgresql/18/bin/psql' -X -At -d 'academy_lab' -c 'SHOW config_file')
hba=$('/usr/lib/postgresql/18/bin/psql' -X -At -d 'academy_lab' -c 'SHOW hba_file')
ident=$('/usr/lib/postgresql/18/bin/psql' -X -At -d 'academy_lab' -c 'SHOW ident_file')
test "$config" = "$data_dir/postgresql.conf" && test "$hba" = "$data_dir/pg_hba.conf" && test "$ident" = "$data_dir/pg_ident.conf" || exit 1

در دیتابیس دورریختنی یک schema تازه و یک جدول کوچک ساخته می‌شود. اگر نام schema از قبل وجود دارد، اجرا باید متوقف شود؛ آن را حذف یا جایگزین نکنید. ردیف before-change نشانه‌ای است که بعداً باید در نسخهٔ بازیابی‌شده ببینید.

'/usr/lib/postgresql/18/bin/psql' -X -v ON_ERROR_STOP=1 -d 'academy_lab' <<'SQL'
CREATE SCHEMA academy_pitr_probe;
CREATE TABLE academy_pitr_probe.marker (id integer PRIMARY KEY, note text NOT NULL);
INSERT INTO academy_pitr_probe.marker VALUES (1, 'before-change');
SELECT * FROM academy_pitr_probe.marker;
SQL

پیش از ثبت نقطهٔ هدف، از همین کلاستر یک بکاپ کامل بگیرید. این کار روی دیسک و مخزن بار ایجاد می‌کند؛ ظرفیت و زمان آن باید با مسئول بکاپ هماهنگ باشد. برچسب بکاپ موفق را از خروجی info بردارید و در یادداشت خصوصی تمرین نگه دارید.

هدف بازیابی در مرحلهٔ بعد ساخته می‌شود و باید پس از پایان همین بکاپ باشد. هنگام بازیابی، همان برچسب را صریح انتخاب می‌کنیم؛ انتخاب خودکار یک بکاپ جدیدتر ممکن است ما را از لحظهٔ موردنظر جلوتر ببرد.

pgbackrest --stanza='academy' --type=full backup
pgbackrest --stanza='academy' info