الاحتفاظ بنسخة احتياطية من البيانات واستعادتها

توضّح هذه الصفحة كيفية استخدام ميزة Cloud Firestoreالنُسخ الاحتياطية المجدوَلة. استخدِم النُسخ الاحتياطية لحماية بياناتك من التلف على مستوى التطبيق أو من حذف البيانات بدون قصد.

تتيح لك عمليات الاحتفاظ بنسخة احتياطية ضبط جداول الاحتفاظ بنسخة احتياطية من أجل الاحتفاظ بنسخة احتياطية من قاعدة البيانات المحدّدة يوميًا أو أسبوعيًا. يمكنك بعد ذلك استخدام هذه النُسخ الاحتياطية لاستعادة data إلى قاعدة بيانات جديدة.

لمحة عن النُسخ الاحتياطية

النسخة الاحتياطية هي نسخة متّسقة من قاعدة البيانات في وقت معيّن. تحتوي النسخة الاحتياطية على جميع البيانات وإعدادات الفهرس في تلك النقطة الزمنية. لا تحتوي النسخة الاحتياطية على سياسات مدة الصلاحية لقاعدة البيانات. تتوفّر النسخة الاحتياطية في الموقع الجغرافي نفسه لقاعدة البيانات المصدر.

تتضمّن النُسخ الاحتياطية فترة الاحتفاظ بالبيانات التي يمكن ضبطها، ويتم تخزينها إلى أن تنتهي فترة الاحتفاظ بالبيانات أو إلى أن تحذف النسخة الاحتياطية. لا يؤدي حذف قاعدة بيانات المصدر إلى حذف النُسخ الاحتياطية ذات الصلة تلقائيًا.

تخزِّن 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: أذونات لبدء عمليات الاستعادة

إنشاء جداول احتياطية وإدارتها

توضّح الأمثلة أدناه كيفية إعداد جدول زمني احتياطي. لكل قاعدة بيانات، يمكنك ضبط جدول زمني واحد بحد أقصى للاحتفاظ بنسخة احتياطية يوميًا وجدول زمني واحد بحد أقصى للاحتفاظ بنسخة احتياطية أسبوعيًا. لا يمكنك ضبط جداول زمنية متعددة للاحتفاظ بنسخة احتياطية أسبوعيًا في أيام مختلفة من الأسبوع.

لا يمكنك ضبط الوقت المحدد بدقة لإنشاء النسخة الاحتياطية. يتم إنشاء نُسخ احتياطية في أوقات مختلفة كل يوم. بالنسبة إلى جداول النسخ الاحتياطي الأسبوعية، يمكنك ضبط يوم الأسبوع للاحتفاظ بنسخة احتياطية.

إنشاء جدول زمني احتياطي

لإنشاء جدول زمني للنسخ الاحتياطي لقاعدة بيانات، استخدِم الأمر gcloud firestore backups schedules create أو الأمر firebase firestore:databases:backups:schedules.

إنشاء جدول زمني يومي للاحتفاظ بنسخة احتياطية

gcloud

لإنشاء جدول زمني يومي للاحتفاظ بنسخة احتياطية، اضبط العلامة --recurrence على daily:

gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

استبدِل ما يلي:

• DATABASE_ID: رقم تعريف قاعدة البيانات المطلوب الاحتفاظ بنسخة احتياطية منها. اضبط القيمة على '(default)' لقاعدة البيانات التلقائية.
• RETENTION_PERIOD: اضبط هذه القيمة على مدة تصل إلى 14 أسبوعًا (14w).

Firebase CLI

لإنشاء جدول زمني يومي للاحتفاظ بنسخة احتياطية، اضبط العلامة --recurrence على DAILY:

firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'DAILY' \
--retention RETENTION_PERIOD

استبدِل ما يلي:

• DATABASE_ID: رقم تعريف قاعدة البيانات المطلوب الاحتفاظ بنسخة احتياطية منها. اضبط القيمة على '(default)' لقاعدة البيانات التلقائية.
• RETENTION_PERIOD: اضبط هذه القيمة على مدة تصل إلى 14 أسبوعًا (14w).

Terraform

لإنشاء جدول زمني احتياطي يومي، أنشئ مورد 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 أسبوعًا).

إنشاء جدول زمني احتياطي أسبوعي

gcloud

لإنشاء جدول زمني احتياطي أسبوعي، اضبط العلامة --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 ليوم السبت

Firebase CLI

لإنشاء جدول زمني احتياطي أسبوعي، اضبط العلامة --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 ليوم السبت

Terraform

لإنشاء جدول زمني احتياطي أسبوعي، أنشئ مورد 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 ليوم السبت

عرض الجداول الزمنية للنسخ الاحتياطي

لعرض جميع الجداول الزمنية للاحتفاظ بنسخة احتياطية من قاعدة بيانات، استخدِم إحدى الطريقتَين التاليتَين:

gcloud

استخدِم الأمر gcloud firestore backups schedules list.

gcloud firestore backups schedules list \
--database='DATABASE_ID'

استبدِل DATABASE_ID بمعرّف قاعدة البيانات. استخدِم '(default)' لقاعدة البيانات التلقائية.

Firebase CLI

استخدِم الأمر firebase firestore:backups:schedules:list.

firebase firestore:backups:schedules:list \
--database 'DATABASE_ID'

استبدِل DATABASE_ID بمعرّف قاعدة البيانات. استخدِم '(default)' لقاعدة البيانات التلقائية.

وصف الجدول الزمني للاحتفاظ بنسخة احتياطية

لاسترداد معلومات عن جدول زمني للاحتفاظ بنسخة احتياطية، استخدِم إحدى الطريقتَين التاليتَين:

gcloud

استخدِم الأمر gcloud firestore backups schedules describe:

gcloud firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

استبدِل ما يلي:

• DATABASE_ID: رقم تعريف قاعدة البيانات المطلوب الاحتفاظ بنسخة احتياطية منها. اضبط القيمة على '(default)' لقاعدة البيانات التلقائية.
• BACKUP_SCHEDULE_ID: رقم تعريف جدول زمني احتياطي. يمكنك الاطّلاع على معرّف كل جدول زمني احتياطي عند إدراج جميع الجداول الزمنية الاحتياطية.

تعديل جدول زمني للنسخ الاحتياطي

لتعديل فترة الاحتفاظ بجدول زمني احتياطي، استخدِم إحدى الطريقتَين التاليتَين:

gcloud

استخدِم الأمر 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 CLI

استخدِم الأمر firebase firestore:backups:schedules:update:

firebase firestore:backups:schedules:update \
BACKUP_SCHEDULE \
--retention RETENTION_PERIOD

استبدِل ما يلي:

• BACKUP_SCHEDULE: اسم المورد الكامل لجدول زمني للاحتفاظ بنسخة احتياطية يمكنك الاطّلاع على اسم كل جدول زمني للنسخ الاحتياطية عند إدراج جميع الجداول الزمنية للنسخ الاحتياطية.
• RETENTION_PERIOD: اضبط هذه القيمة على مدة تصل إلى 14 أسبوعًا (14w).

يمكنك تعديل فترة الاحتفاظ بجدول زمني احتياطي، ولكن لا يمكنك تعديل تكراره. إذا كنت بحاجة إلى جدول احتياطي بمعدل تكرار مختلف، احذف الجدول الاحتياطي القديم إذا لم يعُد مطلوبًا وأنشئ جدولًا احتياطيًا جديدًا بالمعدل المطلوب.

حذف جدول زمني للنسخ الاحتياطية

لحذف جدول زمني للنسخ الاحتياطية، استخدِم إحدى الطريقتَين التاليتَين:

gcloud

استخدِم الأمر 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 CLI

استخدِم الأمر firebase firestore:backups:schedules:delete:

firebase firestore:backups:schedules:delete \
BACKUP_SCHEDULE

استبدِل ما يلي:

• BACKUP_SCHEDULE: اسم المورد الكامل لجدول زمني للاحتفاظ بنسخة احتياطية يمكنك الاطّلاع على اسم كل جدول زمني للنسخ الاحتياطية عند إدراج جميع الجداول الزمنية للنسخ الاحتياطية.

يُرجى العلم أنّ حذف جدول زمني للنسخ الاحتياطية لن يؤدي إلى حذف النُسخ الاحتياطية التي تم إنشاؤها من قبل باستخدام هذا الجدول الزمني. يمكنك الانتظار حتى تنتهي صلاحيتها بعد انتهاء فترة الاحتفاظ بالبيانات، أو لحذف نسخة احتياطية يدويًا، يُرجى الاطّلاع على حذف نسخة احتياطية.

إدارة النُسخ الاحتياطية

إدراج النُسخ الاحتياطية

لعرض النُسخ الاحتياطية المتاحة، استخدِم إحدى الطريقتَين التاليتَين:

gcloud

استخدِم الأمر 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 CLI

استخدِم الأمر firebase firestore:backups:list:

firebase firestore:backups:list

لعرض النُسخ الاحتياطية من موقع جغرافي معيّن فقط، استخدِم العلامة --location:

firebase firestore:backups:list \
--location=LOCATION

استبدِل LOCATION باسم Cloud Firestore الموقع الجغرافي.

وصف نسخة احتياطية

للاطّلاع على تفاصيل حول خدمة احتياطية، استخدِم إحدى الطريقتَين التاليتَين:

gcloud

استخدِم الأمر gcloud firestore backups describe:

gcloud firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID

استبدِل ما يلي:

• LOCATION: الموقع الجغرافي لقاعدة البيانات
• BACKUP_ID: رقم تعريف نسخة احتياطية. يمكنك الاطّلاع على رقم تعريف كل نسخة احتياطية عند عرض قائمة بجميع النُسخ الاحتياطية.

Firebase CLI

استخدِم الأمر firebase firestore:backups:get:

firebase firestore:backups:get BACKUP

استبدِل ما يلي:

• BACKUP: اسم المورد الكامل لنسخة احتياطية يمكنك الاطّلاع على اسم كل نسخة احتياطية عند إدراج جميع النُسخ الاحتياطية.

حذف النسخة الاحتياطية

لحذف نسخة احتياطية، استخدِم إحدى الطريقتَين التاليتَين: تحذير: لا يمكنك استرداد نسخة احتياطية تم حذفها.

gcloud

استخدِم الأمر gcloud firestore backups delete:

gcloud firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID

استبدِل ما يلي:

• LOCATION: الموقع الجغرافي لقاعدة البيانات
• BACKUP_ID: رقم تعريف نسخة احتياطية. يمكنك الاطّلاع على رقم تعريف كل نسخة احتياطية عند عرض قائمة بجميع النُسخ الاحتياطية.

Firebase CLI

استخدِم الأمر firebase firestore:backups:delete:

firebase firestore:backups:delete \
BACKUP

استبدِل ما يلي:

• BACKUP: اسم المورد الكامل لنسخة احتياطية يمكنك الاطّلاع على اسم كل نسخة احتياطية عند عرض جميع النُسخ الاحتياطية.

ملاحظة: يخزِّن Cloud Firestore البيانات الوصفية المتعلّقة بعمليات الاحتفاظ بنسخة احتياطية وجدول الاحتفاظ بنسخة احتياطية المتعلّق بقاعدة بيانات. يحتفظ Cloud Firestore بهذه البيانات الوصفية إلى أن تنتهي صلاحية جميع النُسخ الاحتياطية للقاعدة البيانات أو يتم حذفها.

استعادة البيانات من نسخة احتياطية من قاعدة البيانات

تُسجِّل عملية الاستعادة البيانات من نسخة احتياطية في Cloud Firestore قاعدة بيانات جديدة.

لبدء عملية استعادة، استخدِم إحدى الطريقتَين التاليتَين:

gcloud

استخدِم الأمر 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 CLI

استخدِم الأمر firebase firestore:databases:restore:

firebase firestore:databases:restore \
--backup 'BACKUP' \
--database 'DATABASE_ID'

استبدِل ما يلي:

• BACKUP: اسم المورد الكامل لنسخة احتياطية يمكنك الاطّلاع على اسم كل نسخة احتياطية عند إدراج جميع النُسخ الاحتياطية.
• DATABASE_ID: رقم تعريف قاعدة بيانات قاعدة البيانات الجديدة لا يمكنك استخدام معرّف قاعدة بيانات قيد الاستخدام.