إجراء استعادة في مكانها

ينطبق على إصدار Cloud Firestore Standard وإصدار Cloud Firestore Enterprise.

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

الاستعادة في المكان

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

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

إجراء عملية استعادة في مكانها

لإجراء عملية استعادة في مكانها، اتّبِع الخطوات التالية:

  1. حدِّد النسخة الاحتياطية التي تريد استخدامها لعملية الاستعادة.
  2. احذف قاعدة البيانات الحالية.
  3. استخدِم النسخة الاحتياطية ومعرّف قاعدة البيانات المحذوفة لإكمال عملية الاستعادة.
تنبيه: إذا كان تطبيقك يستخدم Cloud Firestore في مكتبة برامج وضع Native وكان عملاؤك يستخدمون ذاكرة تخزين مؤقت غير متصلة بالإنترنت، قد تؤدي عملية الاستعادة الموضعية إلى محو عمليات الكتابة في قاعدة البيانات التي تم استعادتها بدلاً من تجاهل عمليات الكتابة. يمكن أن تحدث هذه الحالة إذا كان العميل المتصل بقاعدة البيانات المحذوفة غير متصل بالإنترنت، وأثناء عدم الاتصال بالإنترنت، تتراكم عمليات الكتابة في ذاكرة التخزين المؤقت في الوقت الذي تجري فيه عملية استعادة في مكانها.

قبل البدء

ننصحك بإكمال الخطوات التالية قبل بدء عملية الاستعادة الموضعية.

استرداد إعدادات الفهرس لقاعدة البيانات ونسخها استخدِم إعدادات الفهرس لإعادة إنشاء الفهارس بعد إكمال عملية الاستعادة الموضعية. استخدِم الأوامر التالية لاسترداد إعدادات الفهرس لقاعدة البيانات:

  • استخدِم gcloud firestore indexes composite list لاسترداد قائمة بالفهارس المركّبة:

        gcloud firestore indexes composite list --database=DATABASE_ID
    

    استبدِل DATABASE_ID بمعرّف قاعدة البيانات.

  • استخدِم gcloud firestore indexes fields list لاسترداد قائمة بإعفاءات الفهرس (المضمّن) ذي الحقل الواحد.

        gcloud firestore indexes fields list --database=DATABASE_ID
    

إجراء عملية استعادة في مكانها

أكمِل الخطوات التالية لتنفيذ عملية استعادة في مكانها. تتطلّب هذه العملية فترة توقّف بين لحظة حذف قاعدة البيانات ووقت اكتمال عملية الاستعادة.

بعد بدء عملية استعادة، لا يمكنك إلغاء العملية ويجب الانتظار إلى أن تكتمل. تشغل عملية الاستعادة على الفور معرّف قاعدة البيانات المستخدَم في العملية.

  1. استخدِم الأمر gcloud firestore backups list لتحديد النسخة الاحتياطية التي سيتم استخدامها في عملية الاستعادة، واحتفظ باسم المورد. يستخدم اسم المصدر التنسيق التالي:

        projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID
    
  2. استخدِم الأمر gcloud firestore databases delete لحذف قاعدة البيانات الحالية:

        gcloud firestore databases delete --database='DATABASE_ID'
    

    استبدِل DATABASE_ID بمعرّف قاعدة البيانات.

  3. يُرجى الانتظار 5 دقائق على الأقل بعد حذف قاعدة البيانات كي يصبح معرّف قاعدة البيانات متاحًا مرة أخرى. ابدأ عملية استعادة باستخدام الأمر gcloud firestore databases restore:

    gcloud firestore databases restore \
    --source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
    --destination-database='DATABASE_ID'
    

    استبدِل DATABASE_ID بمعرّف قاعدة البيانات.

الخطوات التالية