پشتیبان گیری و بازیابی اطلاعات

این صفحه نحوه استفاده از ویژگی پشتیبان گیری برنامه ریزی شده Cloud Firestore را شرح می دهد. از پشتیبان‌گیری برای محافظت از داده‌های خود در برابر خرابی داده‌های سطح برنامه یا حذف تصادفی داده‌ها استفاده کنید.

پشتیبان‌گیری به شما امکان می‌دهد برنامه‌های پشتیبان‌گیری را برای تهیه نسخه پشتیبان روزانه یا هفتگی از پایگاه داده مشخص شده پیکربندی کنید. سپس می توانید از این نسخه های پشتیبان برای بازیابی داده ها به یک پایگاه داده جدید استفاده کنید.

در مورد پشتیبان گیری

یک نسخه پشتیبان یک کپی ثابت از پایگاه داده در یک نقطه از زمان است. نسخه پشتیبان شامل تمام داده ها و تنظیمات فهرست در آن نقطه از زمان است. یک نسخه پشتیبان شامل زمان پایگاه داده تا خط مشی های زنده نیست. یک نسخه پشتیبان در همان مکان پایگاه داده منبع قرار دارد.

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

Cloud Firestore ابرداده های مربوط به پشتیبان گیری و برنامه های پشتیبان گیری مربوط به پایگاه داده را ذخیره می کند. Cloud Firestore این ابرداده را تا زمانی که تمام نسخه‌های پشتیبان برای پایگاه داده منقضی شده یا حذف شوند، حفظ می‌کند.

ایجاد یا حفظ نسخه پشتیبان بر عملکرد خواندن یا نوشتن در پایگاه داده زنده شما تأثیری ندارد.

هزینه ها

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

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

برای جزئیات بیشتر و نرخ های دقیق، صفحه قیمت را ببینید.

قبل از شروع

این ویژگی به برنامه قیمت گذاری Blaze نیاز دارد.

نقش های مورد نیاز

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

  • roles/datastore.owner : دسترسی کامل به پایگاه داده Cloud Firestore
  • نقش‌های زیر نیز موجود هستند اما در کنسول Google Cloud قابل مشاهده نیستند. از Google Cloud CLI برای تخصیص این نقش‌ها استفاده کنید :

    • roles/datastore.backupsAdmin : دسترسی خواندن و نوشتن به نسخه‌های پشتیبان
    • roles/datastore.backupsViewer : خواندن دسترسی به نسخه پشتیبان
    • roles/datastore.backupSchedulesAdmin : دسترسی خواندن و نوشتن به برنامه های پشتیبان گیری
    • roles/datastore.backupSchedulesViewer : خواندن دسترسی به برنامه های پشتیبان
    • roles/datastore.restoreAdmin : مجوزهایی برای شروع عملیات بازیابی

ایجاد و مدیریت برنامه های پشتیبان

مثال های زیر نحوه تنظیم یک برنامه پشتیبان را نشان می دهد. برای هر پایگاه داده، می توانید حداکثر یک برنامه پشتیبان گیری روزانه و حداکثر یک برنامه پشتیبان گیری هفتگی را پیکربندی کنید. شما نمی توانید چندین برنامه پشتیبان گیری هفتگی را برای روزهای مختلف هفته پیکربندی کنید.

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

یک برنامه پشتیبان ایجاد کنید

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

یک برنامه پشتیبان روزانه ایجاد کنید

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه، روی Edit کلیک کنید.
  4. کادر بررسی روزانه را انتخاب کنید، دوره نگهداری را تنظیم کنید و سپس روی ذخیره کلیک کنید.
برای ایجاد یک زمان‌بندی پشتیبان‌گیری برای پایگاه داده، از دستور gcloud firestore backups schedules create استفاده کنید. برای ایجاد یک برنامه پشتیبان روزانه، پرچم --recurrence را روی daily تنظیم کنید:
gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

موارد زیر را جایگزین کنید:

  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.
برای ایجاد یک زمان‌بندی پشتیبان‌گیری برای پایگاه داده، از دستور firebase firestore:databases:backups:schedules استفاده کنید. برای ایجاد یک برنامه پشتیبان روزانه، پرچم --recurrence را روی DAILY تنظیم کنید:
firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'DAILY' \
--retention RETENTION_PERIOD

موارد زیر را جایگزین کنید:

  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.
برای ایجاد یک برنامه پشتیبان گیری روزانه، یک منبع google_firestore_backup_schedule ایجاد کنید.
resource "google_firestore_backup_schedule" "daily-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  daily_recurrence {}
}

موارد زیر را جایگزین کنید:

  • PROJECT_ID : شناسه پروژه.
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • همچنین می توانید از یک مرجع منبع به یک منبع Terraform از نوع google_firestore_database استفاده کنید.
  • RETENTION_PERIOD_SECONDS : این مقدار را بر حسب ثانیه تنظیم کنید و سپس "s" را در نظر بگیرید. حداکثر مقدار 8467200s (14 هفته) است.

یک برنامه پشتیبان هفتگی ایجاد کنید

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه، روی Edit کلیک کنید.
  4. کادر چک هفتگی را انتخاب کنید، یک روز پشتیبان را انتخاب کنید، دوره نگهداری را تنظیم کنید و سپس روی ذخیره کلیک کنید.
برای ایجاد یک برنامه پشتیبان هفتگی، پرچم --recurrence را روی weekly تنظیم کنید:
gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=weekly \
--retention=RETENTION_PERIOD \
--day-of-week=DAY
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.
  • DAY : روز هفته برای گرفتن نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUN برای یکشنبه
    • MON برای دوشنبه
    • TUE برای سه شنبه
    • WED برای چهارشنبه
    • THU برای پنجشنبه
    • FRI برای جمعه
    • برای شنبه SAT
برای ایجاد یک برنامه پشتیبان هفتگی، پرچم --recurrence را روی WEEKLY تنظیم کنید:
firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'WEEKLY' \
--retention RETENTION_PERIOD
--day-of-week DAY
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.
  • DAY : روز هفته برای گرفتن نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUNDAY برای یکشنبه
    • MONDAY برای دوشنبه
    • TUESDAY برای سه شنبه
    • WEDNESDAY برای چهارشنبه
    • THURSDAY برای پنجشنبه
    • FRIDAY برای جمعه
    • SATURDAY برای شنبه
برای ایجاد یک برنامه پشتیبان هفتگی، یک منبع google_firestore_backup_schedule ایجاد کنید.
resource "google_firestore_backup_schedule" "weekly-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  weekly_recurrence {
    day = DAY
  }
}

موارد زیر را جایگزین کنید:

  • PROJECT_ID : شناسه پروژه.
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • همچنین می توانید از یک مرجع منبع به یک منبع Terraform از نوع google_firestore_database استفاده کنید.
  • RETENTION_PERIOD_SECONDS : این مقدار را بر حسب ثانیه تنظیم کنید و سپس "s" را در نظر بگیرید. حداکثر مقدار 8467200s (14 هفته) است.
  • DAY : روز هفته برای گرفتن نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUNDAY برای یکشنبه
    • MONDAY برای دوشنبه
    • TUESDAY برای سه شنبه
    • WEDNESDAY برای چهارشنبه
    • THURSDAY برای پنجشنبه
    • FRIDAY برای جمعه
    • SATURDAY برای شنبه

فهرست برنامه های پشتیبان گیری

برای فهرست کردن تمام برنامه های پشتیبان گیری برای یک پایگاه داده، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. این صفحه برنامه های پشتیبان گیری را شرح می دهد و نسخه های پشتیبان موجود را فهرست می کند.
از دستور gcloud firestore backups schedules list استفاده کنید.
gcloud firestore backups schedules list \
--database='DATABASE_ID'
DATABASE_ID با شناسه پایگاه داده جایگزین کنید. برای پایگاه داده پیش فرض از '(default)' استفاده کنید.
از دستور firebase firestore:backups:schedules:list استفاده کنید.
firebase firestore:backups:schedules:list \
--database 'DATABASE_ID'
DATABASE_ID با شناسه پایگاه داده جایگزین کنید. برای پایگاه داده پیش فرض از '(default)' استفاده کنید.

برنامه پشتیبان گیری را شرح دهید

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

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. این صفحه برنامه های پشتیبان گیری را شرح می دهد و نسخه های پشتیبان موجود را فهرست می کند.
از دستور gcloud firestore backups schedules describe استفاده کنید:
gcloud firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. وقتی همه برنامه‌های پشتیبان‌گیری را فهرست می‌کنید، می‌توانید شناسه هر برنامه پشتیبان‌گیری را مشاهده کنید.

یک برنامه پشتیبان را به روز کنید

برای به روز رسانی دوره نگهداری یک برنامه پشتیبان، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی شده، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه، روی Edit کلیک کنید.
  4. تنظیمات زمان‌بندی پشتیبان‌گیری را ویرایش کنید و سپس روی ذخیره کلیک کنید.
از دستور gcloud firestore backups schedules update استفاده کنید:
gcloud firestore backups schedules update \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID \
--retention=RETENTION_PERIOD
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. وقتی همه برنامه‌های پشتیبان‌گیری را فهرست می‌کنید، می‌توانید شناسه هر برنامه پشتیبان‌گیری را مشاهده کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.
از دستور firebase firestore:backups:schedules:update استفاده کنید:
firebase firestore:backups:schedules:update \
BACKUP_SCHEDULE \
--retention RETENTION_PERIOD
موارد زیر را جایگزین کنید:
  • BACKUP_SCHEDULE : نام منبع کامل یک برنامه پشتیبان. وقتی همه برنامه‌های پشتیبان‌گیری را فهرست می‌کنید، می‌توانید نام هر برنامه پشتیبان‌گیری را مشاهده کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.

می توانید دوره نگهداری یک برنامه پشتیبان را به روز کنید، اما نمی توانید تکرار آن را به روز کنید. اگر به یک برنامه پشتیبان گیری با تکرار متفاوت نیاز دارید، اگر دیگر نیازی به برنامه پشتیبان گیری نیست، آن را حذف کنید و یک برنامه پشتیبان جدید با تکرار مورد نظر ایجاد کنید.

یک برنامه پشتیبان را حذف کنید

برای حذف یک برنامه پشتیبان، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه ، روی ویرایش کلیک کنید.
  4. تنظیمات زمان‌بندی پشتیبان‌گیری را ویرایش کنید و سپس روی ذخیره کلیک کنید.
از دستور gcloud firestore backups schedules delete استفاده کنید:
gcloud firestore backups schedules delete \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. وقتی همه برنامه‌های پشتیبان‌گیری را فهرست می‌کنید، می‌توانید شناسه هر برنامه پشتیبان‌گیری را مشاهده کنید.
از دستور firebase firestore:backups:schedules:delete استفاده کنید:
firebase firestore:backups:schedules:delete \
BACKUP_SCHEDULE
موارد زیر را جایگزین کنید:

توجه داشته باشید که حذف یک برنامه پشتیبان، پشتیبان‌هایی را که قبلاً توسط این زمان‌بندی ایجاد شده‌اند حذف نمی‌کند. می توانید منتظر بمانید تا پس از مدت نگهداری آنها منقضی شود، یا برای حذف دستی یک نسخه پشتیبان، به حذف نسخه پشتیبان مراجعه کنید.

مدیریت پشتیبان گیری

لیست نسخه های پشتیبان

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

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه، روی Edit کلیک کنید.
  4. تنظیمات زمان‌بندی پشتیبان‌گیری را ویرایش کنید و سپس روی ذخیره کلیک کنید.
از دستور gcloud firestore backups list استفاده کنید:
gcloud firestore backups list \
--format="table(name, database, state)"
پرچم --format="table(name, database, state)" خروجی را به فرمتی قابل خواندن تر فرمت می کند. برای فهرست کردن فقط نسخه‌های پشتیبان از یک مکان خاص، از پرچم --location استفاده کنید:
gcloud firestore backups list \
--location=LOCATION \
--format="table(name, database, state)"
LOCATION با نام مکان Cloud Firestore جایگزین کنید.
از دستور firebase firestore:backups:list استفاده کنید:
firebase firestore:backups:list
برای فهرست کردن فقط نسخه‌های پشتیبان از یک مکان خاص، از پرچم --location استفاده کنید:
firebase firestore:backups:list \
--location=LOCATION
LOCATION با نام مکان Cloud Firestore جایگزین کنید.

یک نسخه پشتیبان را توضیح دهید

برای مشاهده جزئیات مربوط به پشتیبان گیری، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. این صفحه برنامه های پشتیبان گیری را شرح می دهد و نسخه های پشتیبان موجود را فهرست می کند.
از دستور gcloud firestore backups describe استفاده کنید:
gcloud firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID
موارد زیر را جایگزین کنید:
از firebase firestore:backups:get :
firebase firestore:backups:get BACKUP
موارد زیر را جایگزین کنید:

پشتیبان را حذف کنید

برای حذف یک نسخه پشتیبان از یکی از روش های زیر استفاده کنید.

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید. صفحه بازیابی فاجعه باز می شود. این صفحه برنامه های پشتیبان گیری را شرح می دهد و نسخه های پشتیبان موجود را فهرست می کند.
  3. در جدول پشتیبان‌گیری ، ردیف پشتیبان‌گیری را پیدا کنید و در ستون Actions ، روی View more ( ) کلیک کنید. روی Delete کلیک کنید.
  4. عمل را با استفاده از فیلد متن تأیید کنید و روی Delete کلیک کنید.
از دستور gcloud firestore backups delete استفاده کنید:
gcloud firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID
موارد زیر را جایگزین کنید:
از دستور firebase firestore:backups:delete استفاده کنید:
firebase firestore:backups:delete \
BACKUP
موارد زیر را جایگزین کنید:

بازیابی اطلاعات از یک نسخه پشتیبان از پایگاه داده

عملیات بازیابی داده ها را از یک نسخه پشتیبان در یک پایگاه داده جدید Cloud Firestore می نویسد.

برای شروع عملیات بازیابی، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید. صفحه بازیابی فاجعه باز می شود. این صفحه برنامه های پشتیبان گیری را شرح می دهد و نسخه های پشتیبان موجود را فهرست می کند.
  3. در جدول پشتیبان‌گیری ، ردیف پشتیبان‌گیری را پیدا کنید و در ستون Actions ، روی View more ( ) کلیک کنید. روی Restore with Cloud Shell کلیک کنید.
  4. پانل Cloud Shell با دستور gcloud CLI برای بازیابی از نسخه پشتیبان انتخاب شده باز می شود. ID_OF_NEW_DATABASE با یک شناسه برای پایگاه داده جایگزین کنید و دستور را اجرا کنید.

    اجرای دستور پاسخی با اطلاعات بیشتر در مورد عملیات برمی گرداند. پایگاه داده به زودی در لیست پایگاه های داده شما ظاهر می شود. عملیات بازیابی مدتی طول می کشد و باید قبل از دسترسی به پایگاه داده کامل شود.

از دستور gcloud firestore databases restore استفاده کنید:
gcloud firestore databases restore \
--source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
--destination-database='DATABASE_ID'
موارد زیر را جایگزین کنید:
  • PROJECT_ID : شناسه پروژه شما.
  • LOCATION : محل پشتیبان گیری از پایگاه داده و مکان پایگاه داده جدید ایجاد شده برای داده های بازیابی شده است.
  • BACKUP_ID : شناسه یک نسخه پشتیبان. وقتی همه نسخه‌های پشتیبان را فهرست می‌کنید، می‌توانید شناسه هر نسخه پشتیبان را مشاهده کنید.
  • DATABASE_ID : شناسه پایگاه داده برای پایگاه داده جدید. شما نمی توانید از شناسه پایگاه داده ای که قبلاً در حال استفاده است استفاده کنید.
خروجی شامل metadata ، name و اجزای response خواهد بود:
metadata:
  '@type': type.googleapis.com/google.firestore.admin.v1.RestoreDatabaseMetadata
  backup: projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID
  database: projects/PROJECT_ID/databases/DATABASE_ID
  operationState: PROCESSING
  progressPercentage:
    completedWork: '20'
    estimatedWork: '100'
  startTime: '2023-12-06T14:20:17.398325Z'
name: projects/PROJECT_ID/databases/DATABASE_ID/operations/operation_uuid
response:
  '@type': type.googleapis.com/google.firestore.admin.v1.Database
  createTime: '2023-12-06T14:20:17.398325Z'
  name: projects/PROJECT_ID/databases/DATABASE_ID
  ...
فیلد metadata شامل یک جزء progressPercentage است که پیشرفت تخمینی بازیابی را تا کنون شرح می‌دهد و یک operationState که وضعیت کلی بازیابی را مشخص می‌کند. برای بازیابی مجدد این اطلاعات، gcloud firestore operations list استفاده کنید:
gcloud firestore operations list --database=DATABASE_ID
یا با استفاده از فیلد name از خروجی شرح داده شده در بالا، با gcloud firestore operations describe :
gcloud firestore operations describe OPERATION_NAME
از دستور firebase firestore:databases:restore استفاده کنید:
firebase firestore:databases:restore \
--backup 'BACKUP' \
--database 'DATABASE_ID'
موارد زیر را جایگزین کنید:
  • BACKUP : نام منبع کامل یک نسخه پشتیبان. وقتی همه نسخه‌های پشتیبان را فهرست می‌کنید، می‌توانید نام هر نسخه پشتیبان را مشاهده کنید.
  • DATABASE_ID : شناسه پایگاه داده برای پایگاه داده جدید. شما نمی توانید از شناسه پایگاه داده ای که قبلاً در حال استفاده است استفاده کنید.
،

این صفحه نحوه استفاده از ویژگی پشتیبان گیری برنامه ریزی شده Cloud Firestore را شرح می دهد. از پشتیبان‌گیری برای محافظت از داده‌های خود در برابر خرابی داده‌های سطح برنامه یا حذف تصادفی داده‌ها استفاده کنید.

پشتیبان‌گیری به شما امکان می‌دهد برنامه‌های پشتیبان‌گیری را برای تهیه نسخه پشتیبان روزانه یا هفتگی از پایگاه داده مشخص شده پیکربندی کنید. سپس می توانید از این نسخه های پشتیبان برای بازیابی داده ها به یک پایگاه داده جدید استفاده کنید.

در مورد پشتیبان گیری

یک نسخه پشتیبان یک کپی ثابت از پایگاه داده در یک نقطه از زمان است. نسخه پشتیبان شامل تمام داده ها و تنظیمات فهرست در آن نقطه از زمان است. یک نسخه پشتیبان شامل زمان پایگاه داده تا خط مشی های زنده نیست. یک نسخه پشتیبان در همان مکان پایگاه داده منبع قرار دارد.

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

Cloud Firestore ابرداده های مربوط به پشتیبان گیری و برنامه های پشتیبان گیری مربوط به پایگاه داده را ذخیره می کند. Cloud Firestore این ابرداده را تا زمانی که تمام نسخه‌های پشتیبان برای پایگاه داده منقضی شده یا حذف شوند، حفظ می‌کند.

ایجاد یا حفظ نسخه پشتیبان بر عملکرد خواندن یا نوشتن در پایگاه داده زنده شما تأثیری ندارد.

هزینه ها

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

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

برای جزئیات بیشتر و نرخ های دقیق، صفحه قیمت را ببینید.

قبل از شروع

این ویژگی به برنامه قیمت گذاری Blaze نیاز دارد.

نقش های مورد نیاز

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

  • roles/datastore.owner : دسترسی کامل به پایگاه داده Cloud Firestore
  • نقش‌های زیر نیز موجود هستند اما در کنسول Google Cloud قابل مشاهده نیستند. از Google Cloud CLI برای تخصیص این نقش‌ها استفاده کنید :

    • roles/datastore.backupsAdmin : دسترسی خواندن و نوشتن به نسخه‌های پشتیبان
    • roles/datastore.backupsViewer : خواندن دسترسی به نسخه پشتیبان
    • roles/datastore.backupSchedulesAdmin : دسترسی خواندن و نوشتن به برنامه های پشتیبان گیری
    • roles/datastore.backupSchedulesViewer : خواندن دسترسی به برنامه های پشتیبان
    • roles/datastore.restoreAdmin : مجوزهایی برای شروع عملیات بازیابی

ایجاد و مدیریت برنامه های پشتیبان

مثال های زیر نحوه تنظیم یک برنامه پشتیبان را نشان می دهد. برای هر پایگاه داده، می توانید حداکثر یک برنامه پشتیبان گیری روزانه و حداکثر یک برنامه پشتیبان گیری هفتگی را پیکربندی کنید. شما نمی توانید چندین برنامه پشتیبان گیری هفتگی را برای روزهای مختلف هفته پیکربندی کنید.

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

یک برنامه پشتیبان ایجاد کنید

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

یک برنامه پشتیبان روزانه ایجاد کنید

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه، روی Edit کلیک کنید.
  4. کادر بررسی روزانه را انتخاب کنید، دوره نگهداری را تنظیم کنید و سپس روی ذخیره کلیک کنید.
برای ایجاد یک زمان‌بندی پشتیبان‌گیری برای پایگاه داده، از دستور gcloud firestore backups schedules create استفاده کنید. برای ایجاد یک برنامه پشتیبان روزانه، پرچم --recurrence را روی daily تنظیم کنید:
gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

موارد زیر را جایگزین کنید:

  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.
برای ایجاد یک زمان‌بندی پشتیبان‌گیری برای پایگاه داده، از دستور firebase firestore:databases:backups:schedules استفاده کنید. برای ایجاد یک برنامه پشتیبان روزانه، پرچم --recurrence را روی DAILY تنظیم کنید:
firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'DAILY' \
--retention RETENTION_PERIOD

موارد زیر را جایگزین کنید:

  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.
برای ایجاد یک برنامه پشتیبان گیری روزانه، یک منبع google_firestore_backup_schedule ایجاد کنید.
resource "google_firestore_backup_schedule" "daily-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  daily_recurrence {}
}

موارد زیر را جایگزین کنید:

  • PROJECT_ID : شناسه پروژه.
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • همچنین می توانید از یک مرجع منبع به یک منبع Terraform از نوع google_firestore_database استفاده کنید.
  • RETENTION_PERIOD_SECONDS : این مقدار را بر حسب ثانیه تنظیم کنید و سپس "s" را در نظر بگیرید. حداکثر مقدار 8467200s (14 هفته) است.

یک برنامه پشتیبان هفتگی ایجاد کنید

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه، روی Edit کلیک کنید.
  4. کادر چک هفتگی را انتخاب کنید، یک روز پشتیبان را انتخاب کنید، دوره نگهداری را تنظیم کنید و سپس روی ذخیره کلیک کنید.
برای ایجاد یک برنامه پشتیبان هفتگی، پرچم --recurrence را روی weekly تنظیم کنید:
gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=weekly \
--retention=RETENTION_PERIOD \
--day-of-week=DAY
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.
  • DAY : روز هفته برای گرفتن نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUN برای یکشنبه
    • MON برای دوشنبه
    • TUE برای سه شنبه
    • WED برای چهارشنبه
    • THU برای پنجشنبه
    • FRI برای جمعه
    • برای شنبه SAT
برای ایجاد یک برنامه پشتیبان هفتگی، پرچم --recurrence را روی WEEKLY تنظیم کنید:
firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'WEEKLY' \
--retention RETENTION_PERIOD
--day-of-week DAY
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.
  • DAY : روز هفته برای گرفتن نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUNDAY برای یکشنبه
    • MONDAY برای دوشنبه
    • TUESDAY برای سه شنبه
    • WEDNESDAY برای چهارشنبه
    • THURSDAY برای پنجشنبه
    • FRIDAY برای جمعه
    • SATURDAY برای شنبه
برای ایجاد یک برنامه پشتیبان هفتگی، یک منبع google_firestore_backup_schedule ایجاد کنید.
resource "google_firestore_backup_schedule" "weekly-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  weekly_recurrence {
    day = DAY
  }
}

موارد زیر را جایگزین کنید:

  • PROJECT_ID : شناسه پروژه.
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • همچنین می توانید از یک مرجع منبع به یک منبع Terraform از نوع google_firestore_database استفاده کنید.
  • RETENTION_PERIOD_SECONDS : این مقدار را بر حسب ثانیه تنظیم کنید و سپس "s" را در نظر بگیرید. حداکثر مقدار 8467200s (14 هفته) است.
  • DAY : روز هفته برای گرفتن نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUNDAY برای یکشنبه
    • MONDAY برای دوشنبه
    • TUESDAY برای سه شنبه
    • WEDNESDAY برای چهارشنبه
    • THURSDAY برای پنجشنبه
    • FRIDAY برای جمعه
    • SATURDAY برای شنبه

فهرست برنامه های پشتیبان گیری

برای فهرست کردن تمام برنامه های پشتیبان گیری برای یک پایگاه داده، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. این صفحه برنامه های پشتیبان گیری را شرح می دهد و نسخه های پشتیبان موجود را فهرست می کند.
از دستور gcloud firestore backups schedules list استفاده کنید.
gcloud firestore backups schedules list \
--database='DATABASE_ID'
DATABASE_ID با شناسه پایگاه داده جایگزین کنید. برای پایگاه داده پیش فرض از '(default)' استفاده کنید.
از دستور firebase firestore:backups:schedules:list استفاده کنید.
firebase firestore:backups:schedules:list \
--database 'DATABASE_ID'
DATABASE_ID با شناسه پایگاه داده جایگزین کنید. برای پایگاه داده پیش فرض از '(default)' استفاده کنید.

برنامه پشتیبان گیری را شرح دهید

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

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. این صفحه برنامه های پشتیبان گیری را شرح می دهد و نسخه های پشتیبان موجود را فهرست می کند.
از دستور gcloud firestore backups schedules describe استفاده کنید:
gcloud firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. وقتی همه برنامه‌های پشتیبان‌گیری را فهرست می‌کنید، می‌توانید شناسه هر برنامه پشتیبان‌گیری را مشاهده کنید.

یک برنامه پشتیبان را به روز کنید

برای به روز رسانی دوره نگهداری یک برنامه پشتیبان، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی شده، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه، روی Edit کلیک کنید.
  4. تنظیمات زمان‌بندی پشتیبان‌گیری را ویرایش کنید و سپس روی ذخیره کلیک کنید.
از دستور gcloud firestore backups schedules update استفاده کنید:
gcloud firestore backups schedules update \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID \
--retention=RETENTION_PERIOD
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. وقتی همه برنامه‌های پشتیبان‌گیری را فهرست می‌کنید، می‌توانید شناسه هر برنامه پشتیبان‌گیری را مشاهده کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.
از دستور firebase firestore:backups:schedules:update استفاده کنید:
firebase firestore:backups:schedules:update \
BACKUP_SCHEDULE \
--retention RETENTION_PERIOD
موارد زیر را جایگزین کنید:
  • BACKUP_SCHEDULE : نام منبع کامل یک برنامه پشتیبان. وقتی همه برنامه‌های پشتیبان‌گیری را فهرست می‌کنید، می‌توانید نام هر برنامه پشتیبان‌گیری را مشاهده کنید.
  • RETENTION_PERIOD : این مقدار را تا 14 هفته ( 14w ) تنظیم کنید.

می توانید دوره نگهداری یک برنامه پشتیبان را به روز کنید، اما نمی توانید تکرار آن را به روز کنید. اگر به یک برنامه پشتیبان گیری با تکرار متفاوت نیاز دارید، اگر دیگر نیازی به برنامه پشتیبان گیری نیست، آن را حذف کنید و یک برنامه پشتیبان جدید با تکرار مورد نظر ایجاد کنید.

یک برنامه پشتیبان را حذف کنید

برای حذف یک برنامه پشتیبان، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه، روی Edit کلیک کنید.
  4. تنظیمات زمان‌بندی پشتیبان‌گیری را ویرایش کنید و سپس روی ذخیره کلیک کنید.
از دستور gcloud firestore backups schedules delete استفاده کنید:
gcloud firestore backups schedules delete \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش‌فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. وقتی همه برنامه‌های پشتیبان‌گیری را فهرست می‌کنید، می‌توانید شناسه هر برنامه پشتیبان‌گیری را مشاهده کنید.
از دستور firebase firestore:backups:schedules:delete استفاده کنید:
firebase firestore:backups:schedules:delete \
BACKUP_SCHEDULE
موارد زیر را جایگزین کنید:

توجه داشته باشید که حذف یک برنامه پشتیبان، پشتیبان‌هایی را که قبلاً توسط این زمان‌بندی ایجاد شده‌اند حذف نمی‌کند. می توانید منتظر بمانید تا پس از مدت نگهداری آنها منقضی شود، یا برای حذف دستی یک نسخه پشتیبان، به حذف نسخه پشتیبان مراجعه کنید.

مدیریت پشتیبان گیری

لیست نسخه های پشتیبان

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

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه، روی Edit کلیک کنید.
  4. تنظیمات زمان‌بندی پشتیبان‌گیری را ویرایش کنید و سپس روی ذخیره کلیک کنید.
از دستور gcloud firestore backups list استفاده کنید:
gcloud firestore backups list \
--format="table(name, database, state)"
پرچم --format="table(name, database, state)" خروجی را به فرمتی قابل خواندن تر فرمت می کند. برای فهرست کردن فقط نسخه‌های پشتیبان از یک مکان خاص، از پرچم --location استفاده کنید:
gcloud firestore backups list \
--location=LOCATION \
--format="table(name, database, state)"
LOCATION با نام مکان Cloud Firestore جایگزین کنید.
از دستور firebase firestore:backups:list استفاده کنید:
firebase firestore:backups:list
برای فهرست کردن فقط نسخه‌های پشتیبان از یک مکان خاص، از پرچم --location استفاده کنید:
firebase firestore:backups:list \
--location=LOCATION
LOCATION با نام مکان Cloud Firestore جایگزین کنید.

یک نسخه پشتیبان را توضیح دهید

برای مشاهده جزئیات مربوط به پشتیبان گیری، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. این صفحه برنامه های پشتیبان گیری را شرح می دهد و نسخه های پشتیبان موجود را فهرست می کند.
از دستور gcloud firestore backups describe استفاده کنید:
gcloud firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID
موارد زیر را جایگزین کنید:
از دستور firebase firestore:backups:get استفاده کنید:
firebase firestore:backups:get BACKUP
موارد زیر را جایگزین کنید:

پشتیبان را حذف کنید

برای حذف یک نسخه پشتیبان از یکی از روش های زیر استفاده کنید.

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید. صفحه بازیابی فاجعه باز می شود. این صفحه برنامه های پشتیبان گیری را شرح می دهد و نسخه های پشتیبان موجود را فهرست می کند.
  3. در جدول پشتیبان‌گیری ، ردیف پشتیبان‌گیری را پیدا کنید و در ستون Actions ، روی View more ( ) کلیک کنید. روی Delete کلیک کنید.
  4. عمل را با استفاده از فیلد متن تأیید کنید و روی Delete کلیک کنید.
از دستور gcloud firestore backups delete استفاده کنید:
gcloud firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID
موارد زیر را جایگزین کنید:
از دستور firebase firestore:backups:delete استفاده کنید:
firebase firestore:backups:delete \
BACKUP
موارد زیر را جایگزین کنید:

بازیابی اطلاعات از یک نسخه پشتیبان از پایگاه داده

عملیات بازیابی داده ها را از یک نسخه پشتیبان در یک پایگاه داده جدید Cloud Firestore می نویسد.

برای شروع عملیات بازیابی، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه های داده، ردیف پایگاه داده را پیدا کنید. در ستون پشتیبان‌گیری‌های زمان‌بندی‌شده، بسته به اینکه برنامه پشتیبان‌گیری وجود داشته باشد، روی مشاهده نسخه‌های پشتیبان یا ویرایش تنظیمات کلیک کنید. صفحه بازیابی فاجعه باز می شود. این صفحه برنامه های پشتیبان گیری را شرح می دهد و نسخه های پشتیبان موجود را فهرست می کند.
  3. در جدول پشتیبان‌گیری ، ردیف پشتیبان‌گیری را پیدا کنید و در ستون Actions ، روی View more ( ) کلیک کنید. روی Restore with Cloud Shell کلیک کنید.
  4. پانل Cloud Shell با دستور gcloud CLI برای بازیابی از نسخه پشتیبان انتخاب شده باز می شود. ID_OF_NEW_DATABASE با یک شناسه برای پایگاه داده جایگزین کنید و دستور را اجرا کنید.

    اجرای دستور پاسخی با اطلاعات بیشتر در مورد عملیات برمی گرداند. پایگاه داده به زودی در لیست پایگاه های داده شما ظاهر می شود. عملیات بازیابی مدتی طول می کشد و باید قبل از دسترسی به پایگاه داده کامل شود.

از دستور gcloud firestore databases restore استفاده کنید:
gcloud firestore databases restore \
--source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
--destination-database='DATABASE_ID'
موارد زیر را جایگزین کنید:
  • PROJECT_ID : شناسه پروژه شما.
  • LOCATION : محل پشتیبان گیری از پایگاه داده و مکان پایگاه داده جدید ایجاد شده برای داده های بازیابی شده است.
  • BACKUP_ID : شناسه یک نسخه پشتیبان. وقتی همه نسخه‌های پشتیبان را فهرست می‌کنید، می‌توانید شناسه هر نسخه پشتیبان را مشاهده کنید.
  • DATABASE_ID : شناسه پایگاه داده برای پایگاه داده جدید. شما نمی توانید از شناسه پایگاه داده ای که قبلاً در حال استفاده است استفاده کنید.
خروجی شامل metadata ، name و اجزای response خواهد بود:
metadata:
  '@type': type.googleapis.com/google.firestore.admin.v1.RestoreDatabaseMetadata
  backup: projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID
  database: projects/PROJECT_ID/databases/DATABASE_ID
  operationState: PROCESSING
  progressPercentage:
    completedWork: '20'
    estimatedWork: '100'
  startTime: '2023-12-06T14:20:17.398325Z'
name: projects/PROJECT_ID/databases/DATABASE_ID/operations/operation_uuid
response:
  '@type': type.googleapis.com/google.firestore.admin.v1.Database
  createTime: '2023-12-06T14:20:17.398325Z'
  name: projects/PROJECT_ID/databases/DATABASE_ID
  ...
فیلد metadata شامل یک جزء progressPercentage است که پیشرفت تخمینی بازیابی را تا کنون شرح می‌دهد و یک operationState که وضعیت کلی بازیابی را مشخص می‌کند. برای بازیابی مجدد این اطلاعات، gcloud firestore operations list استفاده کنید:
gcloud firestore operations list --database=DATABASE_ID
یا با استفاده از فیلد name از خروجی شرح داده شده در بالا، با gcloud firestore operations describe :
gcloud firestore operations describe OPERATION_NAME
از دستور firebase firestore:databases:restore استفاده کنید:
firebase firestore:databases:restore \
--backup 'BACKUP' \
--database 'DATABASE_ID'
موارد زیر را جایگزین کنید:
  • BACKUP : نام منبع کامل یک نسخه پشتیبان. وقتی همه نسخه‌های پشتیبان را فهرست می‌کنید، می‌توانید نام هر نسخه پشتیبان را مشاهده کنید.
  • DATABASE_ID : شناسه پایگاه داده برای پایگاه داده جدید. شما نمی توانید از شناسه پایگاه داده ای که قبلاً در حال استفاده است استفاده کنید.
،

این صفحه نحوه استفاده از ویژگی پشتیبان گیری برنامه ریزی شده Cloud Firestore را شرح می دهد. از پشتیبان‌گیری برای محافظت از داده‌های خود در برابر خرابی داده‌های سطح برنامه یا حذف تصادفی داده‌ها استفاده کنید.

پشتیبان‌گیری به شما امکان می‌دهد برنامه‌های پشتیبان‌گیری را برای تهیه نسخه پشتیبان روزانه یا هفتگی از پایگاه داده مشخص شده پیکربندی کنید. سپس می توانید از این نسخه های پشتیبان برای بازیابی داده ها به یک پایگاه داده جدید استفاده کنید.

در مورد پشتیبان گیری

یک نسخه پشتیبان یک کپی ثابت از پایگاه داده در یک نقطه از زمان است. نسخه پشتیبان شامل تمام داده ها و تنظیمات فهرست در آن نقطه از زمان است. یک نسخه پشتیبان شامل زمان پایگاه داده تا خط مشی های زنده نیست. یک نسخه پشتیبان در همان مکان پایگاه داده منبع قرار دارد.

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

Cloud Firestore ابرداده های مربوط به پشتیبان گیری و برنامه های پشتیبان گیری مربوط به پایگاه داده را ذخیره می کند. Cloud Firestore این ابرداده را تا زمانی که تمام نسخه‌های پشتیبان برای پایگاه داده منقضی شده یا حذف شوند، حفظ می‌کند.

ایجاد یا حفظ نسخه پشتیبان بر عملکرد خواندن یا نوشتن در پایگاه داده زنده شما تأثیری ندارد.

هزینه ها

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

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

برای جزئیات بیشتر و نرخ های دقیق، صفحه قیمت را ببینید.

قبل از شروع

این ویژگی به برنامه قیمت گذاری Blaze نیاز دارد.

نقش های مورد نیاز

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

  • roles/datastore.owner : دسترسی کامل به پایگاه داده Cloud Firestore
  • نقش‌های زیر نیز موجود هستند اما در کنسول Google Cloud قابل مشاهده نیستند. از Google Cloud CLI برای تخصیص این نقش‌ها استفاده کنید :

    • roles/datastore.backupsAdmin : دسترسی خواندن و نوشتن به نسخه‌های پشتیبان
    • roles/datastore.backupsViewer : خواندن دسترسی به نسخه پشتیبان
    • roles/datastore.backupSchedulesAdmin : دسترسی خواندن و نوشتن به برنامه های پشتیبان گیری
    • roles/datastore.backupSchedulesViewer : خواندن دسترسی به برنامه های پشتیبان
    • roles/datastore.restoreAdmin : مجوزهایی برای شروع عملیات بازیابی

ایجاد و مدیریت برنامه های پشتیبان

مثال های زیر نحوه تنظیم یک برنامه پشتیبان را نشان می دهد. برای هر پایگاه داده، می توانید حداکثر یک برنامه پشتیبان گیری روزانه و حداکثر یک برنامه پشتیبان گیری هفتگی را پیکربندی کنید. شما نمی توانید چندین برنامه پشتیبان گیری هفتگی را برای روزهای مختلف هفته پیکربندی کنید.

شما نمی توانید زمان دقیق روز پشتیبان را پیکربندی کنید. پشتیبان گیری هر روز در زمان های مختلف گرفته می شود. برای برنامه های پشتیبان گیری هفتگی ، می توانید روز هفته را پیکربندی کنید تا پشتیبان تهیه شود.

یک برنامه پشتیبان تهیه کنید

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

یک برنامه پشتیبان گیری روزانه ایجاد کنید

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه ، روی ویرایش کلیک کنید.
  4. کادر انتخاب روزانه را انتخاب کنید ، دوره نگهداری را تنظیم کنید و سپس روی ذخیره کلیک کنید.
برای ایجاد یک برنامه پشتیبان گیری برای یک پایگاه داده ، gcloud firestore backups schedules create استفاده کنید. برای ایجاد یک برنامه پشتیبان گیری روزانه ، پرچم --recurrence را به صورت daily تنظیم کنید:
gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

موارد زیر را جایگزین کنید:

  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.
برای ایجاد یک برنامه پشتیبان گیری برای یک پایگاه داده ، firebase firestore:databases:backups:schedules . برای ایجاد یک برنامه پشتیبان گیری روزانه ، پرچم --recurrence را به صورت DAILY تنظیم کنید:
firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'DAILY' \
--retention RETENTION_PERIOD

موارد زیر را جایگزین کنید:

  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.
برای ایجاد یک برنامه پشتیبان گیری روزانه ، یک منبع google_firestore_backup_schedule ایجاد کنید.
resource "google_firestore_backup_schedule" "daily-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  daily_recurrence {}
}

موارد زیر را جایگزین کنید:

  • PROJECT_ID : شناسه پروژه.
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • همچنین می توانید از یک منبع منبع به منبع Terraform از نوع google_firestore_database استفاده کنید.
  • RETENTION_PERIOD_SECONDS : این را در یک ثانیه به یک مقدار تنظیم کنید و به دنبال آن "S". حداکثر مقدار 8467200s (14 هفته) است.

یک برنامه پشتیبان گیری هفتگی ایجاد کنید

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه ، روی ویرایش کلیک کنید.
  4. کادر چک هفتگی را انتخاب کنید ، یک روز پشتیبان را انتخاب کنید ، دوره نگهداری را تنظیم کنید و سپس روی ذخیره کلیک کنید.
برای ایجاد یک برنامه پشتیبان گیری هفتگی ، پرچم --recurrence را به weekly تنظیم کنید:
gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=weekly \
--retention=RETENTION_PERIOD \
--day-of-week=DAY
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.
  • DAY : روز هفته برای تهیه نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUN برای یکشنبه
    • MON برای دوشنبه
    • TUE شنبه
    • WED چهارشنبه
    • THU برای پنجشنبه
    • FRI برای جمعه
    • SAT برای شنبه
برای ایجاد یک برنامه پشتیبان گیری هفتگی ، پرچم --recurrence را به WEEKLY تنظیم کنید:
firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'WEEKLY' \
--retention RETENTION_PERIOD
--day-of-week DAY
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.
  • DAY : روز هفته برای تهیه نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUNDAY برای یکشنبه
    • MONDAY برای دوشنبه
    • TUESDAY برای سه شنبه
    • WEDNESDAY برای چهارشنبه
    • THURSDAY برای پنجشنبه
    • FRIDAY برای جمعه
    • SATURDAY برای شنبه
برای ایجاد یک برنامه پشتیبان گیری هفتگی ، یک منبع google_firestore_backup_schedule ایجاد کنید.
resource "google_firestore_backup_schedule" "weekly-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  weekly_recurrence {
    day = DAY
  }
}

موارد زیر را جایگزین کنید:

  • PROJECT_ID : شناسه پروژه.
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • همچنین می توانید از یک منبع منبع به منبع Terraform از نوع google_firestore_database استفاده کنید.
  • RETENTION_PERIOD_SECONDS : این را در یک ثانیه به یک مقدار تنظیم کنید و به دنبال آن "S". حداکثر مقدار 8467200s (14 هفته) است.
  • DAY : روز هفته برای تهیه نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUNDAY برای یکشنبه
    • MONDAY برای دوشنبه
    • TUESDAY برای سه شنبه
    • WEDNESDAY برای چهارشنبه
    • THURSDAY برای پنجشنبه
    • FRIDAY برای جمعه
    • SATURDAY برای شنبه

برنامه های پشتیبان گیری را لیست کنید

برای لیست کلیه برنامه های پشتیبان گیری برای یک بانک اطلاعاتی ، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. در این صفحه برنامه های پشتیبان تهیه شده و لیست های پشتیبان تهیه شده است.
از دستور gcloud firestore backups schedules list استفاده کنید.
gcloud firestore backups schedules list \
--database='DATABASE_ID'
DATABASE_ID با شناسه پایگاه داده جایگزین کنید. '(default)' برای پایگاه داده پیش فرض استفاده کنید.
از firebase firestore:backups:schedules:list استفاده کنید.
firebase firestore:backups:schedules:list \
--database 'DATABASE_ID'
DATABASE_ID با شناسه پایگاه داده جایگزین کنید. '(default)' برای پایگاه داده پیش فرض استفاده کنید.

برنامه پشتیبان گیری را توصیف کنید

برای بازیابی اطلاعات در مورد برنامه پشتیبان گیری ، از یکی از روشهای زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. در این صفحه برنامه های پشتیبان تهیه شده و لیست های پشتیبان تهیه شده است.
gcloud firestore backups schedules describe استفاده کنید:
gcloud firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. هنگام لیست همه برنامه های پشتیبان ، می توانید شناسه هر برنامه پشتیبان را مشاهده کنید.

یک برنامه پشتیبان را به روز کنید

برای به روزرسانی دوره نگهداری یک برنامه پشتیبان ، از یکی از روشهای زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه ، روی ویرایش کلیک کنید.
  4. تنظیمات برنامه پشتیبان را ویرایش کرده و سپس روی ذخیره کلیک کنید.
از دستور gcloud firestore backups schedules update استفاده کنید:
gcloud firestore backups schedules update \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID \
--retention=RETENTION_PERIOD
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. هنگام لیست همه برنامه های پشتیبان ، می توانید شناسه هر برنامه پشتیبان را مشاهده کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.
از firebase firestore:backups:schedules:update :
firebase firestore:backups:schedules:update \
BACKUP_SCHEDULE \
--retention RETENTION_PERIOD
موارد زیر را جایگزین کنید:
  • BACKUP_SCHEDULE : نام کامل منابع یک برنامه پشتیبان. هنگام لیست همه برنامه های پشتیبان ، می توانید نام هر برنامه پشتیبان را مشاهده کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.

می توانید دوره نگهداری یک برنامه پشتیبان را به روز کنید ، اما نمی توانید عود آن را به روز کنید. اگر به برنامه پشتیبان گیری با عود متفاوت نیاز دارید ، در صورت نیاز به برنامه پشتیبان گیری قدیمی ، برنامه پشتیبان گیری قدیمی را حذف کنید و با عود دلخواه یک برنامه پشتیبان جدید ایجاد کنید.

یک برنامه پشتیبان را حذف کنید

برای حذف یک برنامه پشتیبان ، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه ، روی ویرایش کلیک کنید.
  4. تنظیمات برنامه پشتیبان را ویرایش کرده و سپس روی ذخیره کلیک کنید.
با استفاده از برنامه gcloud firestore backups schedules delete استفاده کنید:
gcloud firestore backups schedules delete \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. هنگام لیست همه برنامه های پشتیبان ، می توانید شناسه هر برنامه پشتیبان را مشاهده کنید.
از firebase firestore:backups:schedules:delete :
firebase firestore:backups:schedules:delete \
BACKUP_SCHEDULE
موارد زیر را جایگزین کنید:

توجه داشته باشید که حذف یک برنامه پشتیبان تهیه نسخه پشتیبان تهیه شده توسط این برنامه را حذف نمی کند. شما می توانید منتظر انقضا آنها پس از دوره نگهداری آنها یا حذف دستی یک نسخه پشتیبان تهیه شوید ، به Delete Backup مراجعه کنید.

مدیریت پشتیبان گیری

لیست نسخه های پشتیبان

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

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه ، روی ویرایش کلیک کنید.
  4. تنظیمات برنامه پشتیبان را ویرایش کرده و سپس روی ذخیره کلیک کنید.
از دستور gcloud firestore backups list استفاده کنید:
gcloud firestore backups list \
--format="table(name, database, state)"
--format="table(name, database, state)" پرچم خروجی را با فرمت قابل خواندن تر می کند. برای لیست فقط نسخه های پشتیبان از یک مکان خاص ، از پرچم --location استفاده کنید:
gcloud firestore backups list \
--location=LOCATION \
--format="table(name, database, state)"
LOCATION با نام یک مکان Cloud Firestore جایگزین کنید.
از firebase firestore:backups:list Command:
firebase firestore:backups:list
برای لیست فقط نسخه های پشتیبان از یک مکان خاص ، از پرچم --location استفاده کنید:
firebase firestore:backups:list \
--location=LOCATION
LOCATION با نام یک مکان Cloud Firestore جایگزین کنید.

یک نسخه پشتیبان را توصیف کنید

برای مشاهده جزئیات مربوط به نسخه پشتیبان ، از یکی از روشهای زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. در این صفحه برنامه های پشتیبان تهیه شده و لیست های پشتیبان تهیه شده است.
با استفاده از gcloud firestore backups describe Command:
gcloud firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID
موارد زیر را جایگزین کنید:
از firebase firestore:backups:get :
firebase firestore:backups:get BACKUP
موارد زیر را جایگزین کنید:

تهیه نسخه پشتیبان

برای حذف نسخه پشتیبان ، از یکی از روش های زیر استفاده کنید.

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید. صفحه بازیابی فاجعه باز می شود. در این صفحه برنامه های پشتیبان تهیه شده و لیست های پشتیبان تهیه شده است.
  3. در جدول Backups ، ردیف پشتیبان گیری را پیدا کنید و در ستون Actions ، روی View More ( ) کلیک کنید. روی Delete کلیک کنید.
  4. با استفاده از قسمت متن ، عمل را تأیید کنید و روی حذف کلیک کنید.
از gcloud firestore backups delete استفاده کنید:
gcloud firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID
موارد زیر را جایگزین کنید:
از firebase firestore:backups:delete :
firebase firestore:backups:delete \
BACKUP
موارد زیر را جایگزین کنید:

بازیابی داده ها از پشتیبان گیری از پایگاه داده

یک عملیات بازیابی ، داده ها را از پشتیبان گرفته تا یک پایگاه داده جدید Cloud Firestore می نویسد.

برای شروع عملیات بازیابی ، از یکی از روشهای زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید. صفحه بازیابی فاجعه باز می شود. در این صفحه برنامه های پشتیبان تهیه شده و لیست های پشتیبان تهیه شده است.
  3. در جدول Backups ، ردیف پشتیبان گیری را پیدا کنید و در ستون Actions ، روی View More ( ) کلیک کنید. روی Restore با Cloud Shell کلیک کنید.
  4. پانل Cloud Shell با یک دستور gcloud CLI باز می شود تا از پشتیبان انتخاب شده بازگردد. ID_OF_NEW_DATABASE با شناسه برای پایگاه داده جایگزین کرده و دستور را اجرا کنید.

    اجرای دستور با اطلاعات بیشتر در مورد این عمل پاسخ می دهد. این بانک اطلاعاتی به زودی در لیست پایگاه داده های شما ظاهر می شود. عملیات بازیابی مدتی طول می کشد و قبل از دسترسی به پایگاه داده باید تکمیل شود.

از دستور gcloud firestore databases restore استفاده کنید:
gcloud firestore databases restore \
--source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
--destination-database='DATABASE_ID'
موارد زیر را جایگزین کنید:
  • PROJECT_ID : شناسه پروژه شما.
  • LOCATION : محل تهیه نسخه پشتیبان از پایگاه داده و مکان پایگاه داده جدید ایجاد شده برای داده های بازسازی شده.
  • BACKUP_ID : شناسه پشتیبان. هنگام لیست همه نسخه های پشتیبان ، می توانید شناسه هر نسخه پشتیبان را مشاهده کنید.
  • DATABASE_ID : شناسه پایگاه داده برای پایگاه داده جدید. شما نمی توانید از شناسه پایگاه داده ای که در حال استفاده است استفاده کنید.
خروجی شامل metadata ، name و مؤلفه های response خواهد بود:
metadata:
  '@type': type.googleapis.com/google.firestore.admin.v1.RestoreDatabaseMetadata
  backup: projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID
  database: projects/PROJECT_ID/databases/DATABASE_ID
  operationState: PROCESSING
  progressPercentage:
    completedWork: '20'
    estimatedWork: '100'
  startTime: '2023-12-06T14:20:17.398325Z'
name: projects/PROJECT_ID/databases/DATABASE_ID/operations/operation_uuid
response:
  '@type': type.googleapis.com/google.firestore.admin.v1.Database
  createTime: '2023-12-06T14:20:17.398325Z'
  name: projects/PROJECT_ID/databases/DATABASE_ID
  ...
قسمت metadata شامل یک مؤلفه progressPercentage است که جزئیات تخمین زده شده از بازیابی را تا کنون شرح می دهد ، و یک operationState که وضعیت کلی بازیابی را مشخص می کند. برای بازیابی مجدد این اطلاعات ، gcloud firestore operations list استفاده کنید:
gcloud firestore operations list --database=DATABASE_ID
یا با استفاده از قسمت name از خروجی که در بالا توضیح داده شد ، با gcloud firestore operations describe :
gcloud firestore operations describe OPERATION_NAME
از firebase firestore:databases:restore دستور:
firebase firestore:databases:restore \
--backup 'BACKUP' \
--database 'DATABASE_ID'
موارد زیر را جایگزین کنید:
  • BACKUP : نام کامل منابع پشتیبان. هنگام لیست همه نسخه های پشتیبان ، می توانید نام هر نسخه پشتیبان را مشاهده کنید.
  • DATABASE_ID : شناسه پایگاه داده برای پایگاه داده جدید. شما نمی توانید از شناسه پایگاه داده ای که در حال استفاده است استفاده کنید.
،

در این صفحه نحوه استفاده از ویژگی پشتیبان گیری برنامه ریزی شده Cloud Firestore توضیح داده شده است. برای محافظت از داده های خود در برابر فساد داده های سطح برنامه یا حذف داده های تصادفی از نسخه پشتیبان تهیه کنید.

پشتیبان گیری به شما امکان می دهد تا برنامه های پشتیبان تهیه کنید تا نسخه پشتیبان تهیه شده روزانه یا هفتگی از پایگاه داده مشخص شده استفاده کنید. سپس می توانید از این نسخه های پشتیبان برای بازگرداندن داده ها به یک پایگاه داده جدید استفاده کنید.

درباره پشتیبان گیری

تهیه نسخه پشتیبان یک نسخه مداوم از پایگاه داده در یک مقطع زمانی است. نسخه پشتیبان شامل کلیه داده ها و تنظیمات شاخص در آن مقطع زمانی است. پشتیبان گیری شامل زمان پایگاه داده برای سیاستهای زنده نیست. یک نسخه پشتیبان تهیه شده در همان مکان پایگاه داده منبع است.

نسخه پشتیبان تهیه شده یک دوره احتمالی قابل تنظیم دارد و تا زمانی که دوره نگهداری منقضی شود یا تا زمانی که نسخه پشتیبان تهیه کنید ، ذخیره می شوند. حذف بانک اطلاعاتی منبع به طور خودکار نسخه پشتیبان تهیه نمی کند.

Cloud Firestore ابرداده مربوط به برنامه های پشتیبان و برنامه های پشتیبان مربوط به یک بانک اطلاعاتی را ذخیره می کند. Cloud Firestore این ابرداده را تا زمانی که تمام نسخه های پشتیبان برای بانک اطلاعاتی منقضی شود یا حذف شود ، حفظ می کند.

ایجاد یا حفظ نسخه پشتیبان بر عملکرد خواندن یا نوشتن در پایگاه داده زنده شما تأثیر نمی گذارد.

هزینه ها

هنگامی که از پشتیبان گیری استفاده می کنید ، برای موارد زیر هزینه می شود:

  • مقدار ذخیره سازی استفاده شده توسط هر نسخه پشتیبان.
  • برای یک عملیات بازیابی ، بر اساس اندازه پشتیبان شارژ می شوید.

برای اطلاعات بیشتر و نرخ دقیق ، به صفحه قیمت گذاری مراجعه کنید.

قبل از شروع

این ویژگی به برنامه قیمت گذاری Blaze نیاز دارد.

نقش های مورد نیاز

برای به دست آوردن مجوزهایی که برای مدیریت پشتیبان و برنامه های پشتیبان گیری نیاز دارید ، از مدیر خود بخواهید که یک یا چند مورد از هویت زیر و نقش مدیریت دسترسی را به شما اعطا کند:

  • roles/datastore.owner : دسترسی کامل به پایگاه داده Cloud Firestore
  • نقش های زیر نیز در کنسول Google Cloud در دسترس است اما قابل مشاهده نیست. برای اختصاص این نقش ها از Google Cloud CLI استفاده کنید :

    • roles/datastore.backupsAdmin : دسترسی به نسخه پشتیبان را بخوانید و بنویسید
    • roles/datastore.backupsViewer : دسترسی به نسخه پشتیبان را بخوانید
    • roles/datastore.backupSchedulesAdmin : دسترسی به برنامه های پشتیبان را بخوانید و بنویسید
    • roles/datastore.backupSchedulesViewer : دسترسی به برنامه های پشتیبان را بخوانید
    • roles/datastore.restoreAdmin : مجوزها برای شروع عملیات بازیابی

ایجاد و مدیریت برنامه های پشتیبان

مثالهای زیر نحوه تنظیم برنامه پشتیبان را نشان می دهد. برای هر پایگاه داده ، می توانید حداکثر یک برنامه پشتیبان گیری روزانه و حداکثر یک برنامه پشتیبان گیری هفتگی را پیکربندی کنید. شما نمی توانید چندین برنامه پشتیبان گیری هفتگی را برای روزهای مختلف هفته پیکربندی کنید.

شما نمی توانید زمان دقیق روز پشتیبان را پیکربندی کنید. پشتیبان گیری هر روز در زمان های مختلف گرفته می شود. برای برنامه های پشتیبان گیری هفتگی ، می توانید روز هفته را پیکربندی کنید تا پشتیبان تهیه شود.

یک برنامه پشتیبان تهیه کنید

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

یک برنامه پشتیبان گیری روزانه ایجاد کنید

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه ، روی ویرایش کلیک کنید.
  4. کادر انتخاب روزانه را انتخاب کنید ، دوره نگهداری را تنظیم کنید و سپس روی ذخیره کلیک کنید.
برای ایجاد یک برنامه پشتیبان گیری برای یک پایگاه داده ، gcloud firestore backups schedules create استفاده کنید. برای ایجاد یک برنامه پشتیبان گیری روزانه ، پرچم --recurrence را به صورت daily تنظیم کنید:
gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

موارد زیر را جایگزین کنید:

  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.
برای ایجاد یک برنامه پشتیبان گیری برای یک پایگاه داده ، firebase firestore:databases:backups:schedules . برای ایجاد یک برنامه پشتیبان گیری روزانه ، پرچم --recurrence را به صورت DAILY تنظیم کنید:
firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'DAILY' \
--retention RETENTION_PERIOD

موارد زیر را جایگزین کنید:

  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.
برای ایجاد یک برنامه پشتیبان گیری روزانه ، یک منبع google_firestore_backup_schedule ایجاد کنید.
resource "google_firestore_backup_schedule" "daily-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  daily_recurrence {}
}

موارد زیر را جایگزین کنید:

  • PROJECT_ID : شناسه پروژه.
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • همچنین می توانید از یک منبع منبع به منبع Terraform از نوع google_firestore_database استفاده کنید.
  • RETENTION_PERIOD_SECONDS : این را در یک ثانیه به یک مقدار تنظیم کنید و به دنبال آن "S". حداکثر مقدار 8467200s (14 هفته) است.

یک برنامه پشتیبان گیری هفتگی ایجاد کنید

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه ، روی ویرایش کلیک کنید.
  4. کادر چک هفتگی را انتخاب کنید ، یک روز پشتیبان را انتخاب کنید ، دوره نگهداری را تنظیم کنید و سپس روی ذخیره کلیک کنید.
برای ایجاد یک برنامه پشتیبان گیری هفتگی ، پرچم --recurrence را به weekly تنظیم کنید:
gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=weekly \
--retention=RETENTION_PERIOD \
--day-of-week=DAY
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.
  • DAY : روز هفته برای تهیه نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUN برای یکشنبه
    • MON برای دوشنبه
    • TUE شنبه
    • WED چهارشنبه
    • THU برای پنجشنبه
    • FRI برای جمعه
    • SAT برای شنبه
برای ایجاد یک برنامه پشتیبان گیری هفتگی ، پرچم --recurrence را به WEEKLY تنظیم کنید:
firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'WEEKLY' \
--retention RETENTION_PERIOD
--day-of-week DAY
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.
  • DAY : روز هفته برای تهیه نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUNDAY برای یکشنبه
    • MONDAY برای دوشنبه
    • TUESDAY برای سه شنبه
    • WEDNESDAY برای چهارشنبه
    • THURSDAY برای پنجشنبه
    • FRIDAY برای جمعه
    • SATURDAY برای شنبه
برای ایجاد یک برنامه پشتیبان گیری هفتگی ، یک منبع google_firestore_backup_schedule ایجاد کنید.
resource "google_firestore_backup_schedule" "weekly-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  weekly_recurrence {
    day = DAY
  }
}

موارد زیر را جایگزین کنید:

  • PROJECT_ID : شناسه پروژه.
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • همچنین می توانید از یک منبع منبع به منبع Terraform از نوع google_firestore_database استفاده کنید.
  • RETENTION_PERIOD_SECONDS : این را در یک ثانیه به یک مقدار تنظیم کنید و به دنبال آن "S". حداکثر مقدار 8467200s (14 هفته) است.
  • DAY : روز هفته برای تهیه نسخه پشتیبان. روی یکی از موارد زیر تنظیم کنید:
    • SUNDAY برای یکشنبه
    • MONDAY برای دوشنبه
    • TUESDAY برای سه شنبه
    • WEDNESDAY برای چهارشنبه
    • THURSDAY برای پنجشنبه
    • FRIDAY برای جمعه
    • SATURDAY برای شنبه

برنامه های پشتیبان گیری را لیست کنید

برای لیست کلیه برنامه های پشتیبان گیری برای یک بانک اطلاعاتی ، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. در این صفحه برنامه های پشتیبان تهیه شده و لیست های پشتیبان تهیه شده است.
از دستور gcloud firestore backups schedules list استفاده کنید.
gcloud firestore backups schedules list \
--database='DATABASE_ID'
DATABASE_ID با شناسه پایگاه داده جایگزین کنید. '(default)' برای پایگاه داده پیش فرض استفاده کنید.
از firebase firestore:backups:schedules:list استفاده کنید.
firebase firestore:backups:schedules:list \
--database 'DATABASE_ID'
DATABASE_ID با شناسه پایگاه داده جایگزین کنید. '(default)' برای پایگاه داده پیش فرض استفاده کنید.

برنامه پشتیبان گیری را توصیف کنید

برای بازیابی اطلاعات در مورد برنامه پشتیبان گیری ، از یکی از روشهای زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. در این صفحه برنامه های پشتیبان تهیه شده و لیست های پشتیبان تهیه شده است.
gcloud firestore backups schedules describe استفاده کنید:
gcloud firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. هنگام لیست همه برنامه های پشتیبان ، می توانید شناسه هر برنامه پشتیبان را مشاهده کنید.

یک برنامه پشتیبان را به روز کنید

برای به روزرسانی دوره نگهداری یک برنامه پشتیبان ، از یکی از روشهای زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه ، روی ویرایش کلیک کنید.
  4. تنظیمات برنامه پشتیبان را ویرایش کرده و سپس روی ذخیره کلیک کنید.
از دستور gcloud firestore backups schedules update استفاده کنید:
gcloud firestore backups schedules update \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID \
--retention=RETENTION_PERIOD
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. هنگام لیست همه برنامه های پشتیبان ، می توانید شناسه هر برنامه پشتیبان را مشاهده کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.
از firebase firestore:backups:schedules:update :
firebase firestore:backups:schedules:update \
BACKUP_SCHEDULE \
--retention RETENTION_PERIOD
موارد زیر را جایگزین کنید:
  • BACKUP_SCHEDULE : نام کامل منابع یک برنامه پشتیبان. هنگام لیست همه برنامه های پشتیبان ، می توانید نام هر برنامه پشتیبان را مشاهده کنید.
  • RETENTION_PERIOD : این را تا 14 هفته ( 14w ) تنظیم کنید.

می توانید دوره نگهداری یک برنامه پشتیبان را به روز کنید ، اما نمی توانید عود آن را به روز کنید. اگر به برنامه پشتیبان گیری با عود متفاوت نیاز دارید ، در صورت نیاز به برنامه پشتیبان گیری قدیمی ، برنامه پشتیبان گیری قدیمی را حذف کنید و با عود دلخواه یک برنامه پشتیبان جدید ایجاد کنید.

یک برنامه پشتیبان را حذف کنید

برای حذف یک برنامه پشتیبان ، از یکی از روش های زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه ، روی ویرایش کلیک کنید.
  4. تنظیمات برنامه پشتیبان را ویرایش کرده و سپس روی ذخیره کلیک کنید.
با استفاده از برنامه gcloud firestore backups schedules delete استفاده کنید:
gcloud firestore backups schedules delete \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID
موارد زیر را جایگزین کنید:
  • DATABASE_ID : شناسه پایگاه داده برای تهیه نسخه پشتیبان. برای پایگاه داده پیش فرض روی '(default)' تنظیم کنید.
  • BACKUP_SCHEDULE_ID : شناسه یک برنامه پشتیبان. هنگام لیست همه برنامه های پشتیبان ، می توانید شناسه هر برنامه پشتیبان را مشاهده کنید.
از firebase firestore:backups:schedules:delete :
firebase firestore:backups:schedules:delete \
BACKUP_SCHEDULE
موارد زیر را جایگزین کنید:

توجه داشته باشید که حذف یک برنامه پشتیبان تهیه نسخه پشتیبان تهیه شده توسط این برنامه را حذف نمی کند. شما می توانید منتظر انقضا آنها پس از دوره نگهداری آنها یا حذف دستی یک نسخه پشتیبان تهیه شوید ، به Delete Backup مراجعه کنید.

مدیریت پشتیبان گیری

لیست نسخه های پشتیبان

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

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. برای ویرایش تنظیمات بازیابی فاجعه ، روی ویرایش کلیک کنید.
  4. تنظیمات برنامه پشتیبان را ویرایش کرده و سپس روی ذخیره کلیک کنید.
از دستور gcloud firestore backups list استفاده کنید:
gcloud firestore backups list \
--format="table(name, database, state)"
--format="table(name, database, state)" پرچم خروجی را با فرمت قابل خواندن تر می کند. برای لیست فقط نسخه های پشتیبان از یک مکان خاص ، از پرچم --location استفاده کنید:
gcloud firestore backups list \
--location=LOCATION \
--format="table(name, database, state)"
LOCATION با نام یک مکان Cloud Firestore جایگزین کنید.
از firebase firestore:backups:list Command:
firebase firestore:backups:list
برای لیست فقط نسخه های پشتیبان از یک مکان خاص ، از پرچم --location استفاده کنید:
firebase firestore:backups:list \
--location=LOCATION
LOCATION با نام یک مکان Cloud Firestore جایگزین کنید.

یک نسخه پشتیبان را توصیف کنید

برای مشاهده جزئیات مربوط به نسخه پشتیبان ، از یکی از روشهای زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید.
  3. صفحه بازیابی فاجعه باز می شود. در این صفحه برنامه های پشتیبان تهیه شده و لیست های پشتیبان تهیه شده است.
با استفاده از gcloud firestore backups describe Command:
gcloud firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID
موارد زیر را جایگزین کنید:
از firebase firestore:backups:get :
firebase firestore:backups:get BACKUP
موارد زیر را جایگزین کنید:

تهیه نسخه پشتیبان

برای حذف نسخه پشتیبان ، از یکی از روش های زیر استفاده کنید.

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید. صفحه بازیابی فاجعه باز می شود. در این صفحه برنامه های پشتیبان تهیه شده و لیست های پشتیبان تهیه شده است.
  3. در جدول Backups ، ردیف پشتیبان گیری را پیدا کنید و در ستون Actions ، روی View More ( ) کلیک کنید. روی Delete کلیک کنید.
  4. با استفاده از قسمت متن ، عمل را تأیید کنید و روی حذف کلیک کنید.
از gcloud firestore backups delete استفاده کنید:
gcloud firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID
موارد زیر را جایگزین کنید:
از firebase firestore:backups:delete :
firebase firestore:backups:delete \
BACKUP
موارد زیر را جایگزین کنید:

بازیابی داده ها از پشتیبان گیری از پایگاه داده

یک عملیات بازیابی ، داده ها را از پشتیبان گرفته تا یک پایگاه داده جدید Cloud Firestore می نویسد.

برای شروع عملیات بازیابی ، از یکی از روشهای زیر استفاده کنید:

  1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

    به پایگاه داده ها بروید

  2. در لیست پایگاه داده ها ، ردیف پایگاه داده را پیدا کنید. در ستون برنامه ریزی شده Backups بسته به اینکه آیا یک برنامه پشتیبان وجود دارد ، روی نمای پشتیبان یا تنظیمات ویرایش کلیک کنید. صفحه بازیابی فاجعه باز می شود. در این صفحه برنامه های پشتیبان تهیه شده و لیست های پشتیبان تهیه شده است.
  3. در جدول Backups ، ردیف پشتیبان گیری را پیدا کنید و در ستون Actions ، روی View More ( ) کلیک کنید. روی Restore با Cloud Shell کلیک کنید.
  4. پانل Cloud Shell با یک دستور gcloud CLI باز می شود تا از پشتیبان انتخاب شده بازگردد. ID_OF_NEW_DATABASE با شناسه برای پایگاه داده جایگزین کرده و دستور را اجرا کنید.

    اجرای دستور با اطلاعات بیشتر در مورد این عمل پاسخ می دهد. این بانک اطلاعاتی به زودی در لیست پایگاه داده های شما ظاهر می شود. عملیات بازیابی مدتی طول می کشد و قبل از دسترسی به پایگاه داده باید تکمیل شود.

از دستور gcloud firestore databases restore استفاده کنید:
gcloud firestore databases restore \
--source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
--destination-database='DATABASE_ID'
موارد زیر را جایگزین کنید:
  • PROJECT_ID : شناسه پروژه شما.
  • LOCATION : محل تهیه نسخه پشتیبان از پایگاه داده و مکان پایگاه داده جدید ایجاد شده برای داده های بازسازی شده.
  • BACKUP_ID : شناسه پشتیبان. هنگام لیست همه نسخه های پشتیبان ، می توانید شناسه هر نسخه پشتیبان را مشاهده کنید.
  • DATABASE_ID : شناسه پایگاه داده برای پایگاه داده جدید. شما نمی توانید از شناسه پایگاه داده ای که در حال استفاده است استفاده کنید.
خروجی شامل metadata ، name و مؤلفه های response خواهد بود:
metadata:
  '@type': type.googleapis.com/google.firestore.admin.v1.RestoreDatabaseMetadata
  backup: projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID
  database: projects/PROJECT_ID/databases/DATABASE_ID
  operationState: PROCESSING
  progressPercentage:
    completedWork: '20'
    estimatedWork: '100'
  startTime: '2023-12-06T14:20:17.398325Z'
name: projects/PROJECT_ID/databases/DATABASE_ID/operations/operation_uuid
response:
  '@type': type.googleapis.com/google.firestore.admin.v1.Database
  createTime: '2023-12-06T14:20:17.398325Z'
  name: projects/PROJECT_ID/databases/DATABASE_ID
  ...
قسمت metadata شامل یک مؤلفه progressPercentage است که جزئیات تخمین زده شده از بازیابی را تا کنون شرح می دهد ، و یک operationState که وضعیت کلی بازیابی را مشخص می کند. برای بازیابی مجدد این اطلاعات ، gcloud firestore operations list استفاده کنید:
gcloud firestore operations list --database=DATABASE_ID
یا با استفاده از قسمت name از خروجی که در بالا توضیح داده شد ، با gcloud firestore operations describe :
gcloud firestore operations describe OPERATION_NAME
از firebase firestore:databases:restore دستور:
firebase firestore:databases:restore \
--backup 'BACKUP' \
--database 'DATABASE_ID'
موارد زیر را جایگزین کنید:
  • BACKUP : نام کامل منابع پشتیبان. هنگام لیست همه نسخه های پشتیبان ، می توانید نام هر نسخه پشتیبان را مشاهده کنید.
  • DATABASE_ID : شناسه پایگاه داده برای پایگاه داده جدید. شما نمی توانید از شناسه پایگاه داده ای که در حال استفاده است استفاده کنید.