همه مقالات تخصصی

بکاپ PostgreSQL با pg_dump: فرمت custom، تست بازیابی و نقش‌ها

با pg_dump و فرمت custom از PostgreSQL بکاپ بگیرید، اعتبارنامه را در .pgpass نگه دارید، آرشیو را بسنجید، بازیابی را تست کنید، نقش‌ها را با pg_dumpall ذخیره کنید و فایل‌های قدیمی را بچرخانید.

بکاپ PostgreSQL با pg_dump: فرمت custom، تست بازیابی و نقش‌ها

pg_dump از یک پایگاه داده PostgreSQL در حال اجرا بکاپ منطقی یکدست می‌گیرد. جزئیات تعیین می‌کنند بتوانید بازیابی کنید: فرمت، نقش‌هایی که شامل نمی‌شوند، جای رمز و اینکه آیا هرگز بازیابی را تست کرده‌اید. این راهنما روال عملی را نشان می‌دهد. دستورها از مستندات PostgreSQL آمده‌اند؛ روی سرور شما اجرایشان نکرده‌ام.

۱. با فرمت custom dump بگیرید

فرمت custom فشرده است و اجازه می‌دهد جدول‌های انتخابی یا موازی بازیابی شوند. رمز را در فایل محافظت‌شدهٔ .pgpass نگه دارید:

# Custom format: compressed, selective restore, parallel restore
pg_dump -Fc -d appdb -f /backups/appdb-$(date +%F).dump
# Credentials: use ~/.pgpass (chmod 600), not the command line
# host:port:database:user:password   (one line per server)

dump از لحظهٔ شروع یکدست است و استفادهٔ عادی را مسدود نمی‌کند.

۲. آرشیو را فهرست و بررسی کنید

مطمئن شوید فایل خوانده می‌شود و آنچه انتظار دارید در آن است و روند اندازه را ببینید:

pg_restore --list /backups/appdb-2026-10-31.dump | head -n 20
pg_restore --list /backups/appdb-2026-10-31.dump | wc -l
ls -lh /backups/ | tail -n 5

افت ناگهانی اندازه هشدار است. برای معادل MySQL راهنمای mysqldump را ببینید.

۳. بازیابی را تست کنید

در پایگاه داده جدا بازیابی کنید و تعداد جدول‌ها یا ردیف‌های شناخته‌شده را مقایسه کنید:

createdb restore_test
pg_restore -d restore_test --no-owner -j 2 /backups/appdb-2026-10-31.dump
psql -d restore_test -c '\dt' | head
psql -d restore_test -c 'SELECT count(*) FROM users;'

این را مرتب انجام دهید. بکاپی که هرگز بازیابی نشده فقط یک فرض است.

۴. نقش‌ها را ذخیره و فایل‌ها را بچرخانید

کاربرها و نقش‌ها بیرون dump یک پایگاه هستند، پس آن‌ها را هم ذخیره کنید. فایل‌های قدیمی را با احتیاط بچرخانید:

# Roles and global objects are NOT inside a single-database dump
pg_dumpall --globals-only > /backups/globals-$(date +%F).sql
# Keep 7 dailies
find /backups -name 'appdb-*.dump' -mtime +7 -delete   # review before enabling deletion

بکاپ را بیرون سرور کپی کنید؛ راهنمای بکاپ rsync را ببینید. با قفل و لاگ زمان‌بندی کنید؛ راهنمای تایمرهای systemd را ببینید.

۵. اشتباه‌هایی که باید پرهیز کرد

این میان‌برها بکاپ را بی‌اثر می‌کنند:

pg_dump appdb > dump.sql                  # plain format: no selective or parallel restore
Copying /var/lib/postgresql while running # not a consistent backup
Password on the command line               # visible in the process list
Backups only on the same server            # lost together with the server

بکاپ‌های حاوی داده شخصی را رمزگذاری کنید.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید پایگاه داده برنامه‌ای (ساختگی) ۳ گیگابایت است. dump شبانه با فرمت custom در چند دقیقه تمام می‌شود، بازیابی ماهانه در پایگاه آزمایشی همهٔ جدول‌ها و تعداد انتظاری کاربران را نشان می‌دهد و فایل نقش‌ها اجازه می‌دهد دسترسی‌ها روی سرور جدید بازسازی شوند.

۷. اشتباه‌های رایج

  • فرمت plain برای پایگاه بزرگ.
  • فراموشی نقش‌ها و اشیای سراسری.
  • رمز در خط فرمان.
  • هرگز تست‌نکردن بازیابی.
  • نگه‌داشتن بکاپ روی همان سرور.
  • حذف فایل‌های قدیمی بدون بازبینی.

۸. پرسش‌های متداول

pg_dump پایگاه را قفل می‌کند؟ خواندن و نوشتن عادی را مسدود نمی‌کند، هرچند ممکن است با بعضی تغییرهای schema تداخل کند.

custom یا plain؟ custom برای انعطاف؛ plain اگر SQL خوانا می‌خواهید.

یک جدول را چطور بازیابی کنم؟ از pg_restore با -t استفاده کنید.

کپی فایل کافی است؟ نه، مگر با ابزار درست base backup انجام شود.

۹. چک‌لیست سریع

  1. با فرمت custom dump بگیرید.
  2. از .pgpass استفاده کنید.
  3. آرشیو را فهرست کنید.
  4. در پایگاه آزمایشی بازیابی کنید.
  5. نقش‌ها را dump کنید.
  6. بیرون سرور کپی کنید.
  7. با احتیاط بچرخانید.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

PostgreSQL: pg_dump · PostgreSQL: pg_restore · PostgreSQL: Backup and Restore · PostgreSQL: The Password File