تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ينطبق على إصدار Cloud Firestore Standard وإصدار Cloud Firestore Enterprise.
توضّح هذه الصفحة كيفية استعادة البيانات في نسخة احتياطية إلى قاعدة بيانات تحمل الاسم نفسه الخاص بقاعدة البيانات المصدر للنسخة الاحتياطية.
قبل قراءة هذه الصفحة، يجب أن تكون على دراية بميزة
الاحتفاظ بنسخة احتياطية من البيانات واستعادتها.
الاستعادة في المكان
تتيح لك عملية الاستعادة الموضعية استعادة قاعدة بيانات من نسخة احتياطية إلى قاعدة البيانات المصدر التي أنشأت النسخة الاحتياطية، وذلك أثناء استمرار توفّر قاعدة البيانات الأصلية. تساعدك عملية الاستعادة الموضعية في تجنُّب إعادة توجيه الزيارات أو إنشاء قاعدة بيانات باسم مختلف.
يجب أن تستخدم عملية الاستعادة قاعدة بيانات وجهة غير متوفّرة حاليًا. ومع ذلك، يمكنك محاكاة عملية استعادة في مكانها من خلال حذف قاعدة البيانات المصدر ثم الاستعادة من نسخة احتياطية إلى قاعدة بيانات جديدة تحمل الاسم نفسه.
إجراء عملية استعادة في مكانها
لإجراء عملية استعادة في مكانها، اتّبِع الخطوات التالية:
حدِّد النسخة الاحتياطية التي تريد استخدامها لعملية الاستعادة.
احذف قاعدة البيانات الحالية.
استخدِم النسخة الاحتياطية ومعرّف قاعدة البيانات المحذوفة لإكمال عملية الاستعادة.
قبل البدء
ننصحك بإكمال الخطوات التالية قبل بدء عملية الاستعادة الموضعية:
إذا كنت بحاجة إلى استرداد قاعدة البيانات المحذوفة، عليك استيراد البيانات من عملية التصدير.
لاسترداد قاعدة البيانات المحذوفة إلى رقم تعريف قاعدة البيانات نفسه، عليك الانتظار إلى أن تكتمل أي عمليات استعادة قيد التشغيل، ثم اتّباع الخطوات التالية:
احذف قاعدة البيانات الحالية باستخدام معرّف قاعدة البيانات وانتظِر 5 دقائق على الأقل.
إنشاء قاعدة بيانات جديدة باستخدام معرّف قاعدة البيانات
بدء عملية استيراد
استرداد إعدادات الفهرس في قاعدة البيانات ونسخها لا تسجّل عمليات التصدير تعريفات الفهرس. استخدِم إعدادات الفهرس لإعادة إنشاء الفهارس بعد إكمال عملية الاستعادة الموضعية. استخدِم الأوامر التالية
لاسترداد إعدادات الفهرس لقاعدة البيانات:
gcloud firestore indexes fields list --database=DATABASE_ID
إجراء عملية استعادة في مكانها
أكمِل الخطوات التالية لتنفيذ عملية استعادة في مكانها. تتطلّب هذه العملية فترة توقّف بين لحظة حذف قاعدة البيانات ووقت اكتمال عملية الاستعادة.
بعد بدء عملية استعادة، لا يمكنك إلغاء العملية ويجب الانتظار إلى أن تكتمل. تشغل عملية الاستعادة على الفور معرّف قاعدة البيانات المستخدَم في العملية.
استخدِم الأمر gcloud firestore backups list لتحديد النسخة الاحتياطية التي سيتم استخدامها في عملية الاستعادة، ثم سجِّل اسم المورد. يستخدم اسم المصدر التنسيق التالي:
يُرجى الانتظار 5 دقائق على الأقل بعد حذف قاعدة البيانات كي يصبح معرّف قاعدة البيانات متاحًا مرة أخرى. ابدأ عملية استعادة باستخدام الأمر
gcloud firestore databases restore:
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["\u003cbr /\u003e\n\n\n|----------------------------------------------------------------------------------------|\n| *Relevant to Cloud Firestore Standard edition and Cloud Firestore Enterprise edition.* |\n\n\u003cbr /\u003e\n\nThis page describes how to restore data in a backup to a database with the same\nname as the source database of the backup.\nBefore you read this page, you should be familiar with\n[Back up and restore data](/docs/firestore/enterprise/backups).\n\nIn-place restore\n\nAn in-place restore lets you restore a database from a backup to the\nsource database that created the backup while the original database still\nexists. An in-place restore helps you avoid rerouting traffic\nor creating a database with a different name.\n| **Warning:** Once you start the in-place restore process, the original database is permanently lost, and you can't undo this operation.\n\nA restore operation must use a destination database that\ndoesn't already exist. You can, however, simulate an in-place restore by deleting\nthe source database and then restoring from a backup to a new database with the\nsame name as the source database.\n\nPerform an in-place restore\n\nTo perform an in-place restore, follow these steps:\n\n1. Identify the backup to use for the restore operation.\n2. Delete the existing database.\n3. Use the backup and the database ID of the deleted database to complete the restore operation.\n\n| **Caution:** If your app uses a Cloud Firestore in Native mode client library and your clients use an offline cache, an in-place restore might flush your writes to the restored database instead of discarding the writes. This situation can occur if the client that is connected to the deleted database goes offline and, while offline, the cache accumulates writes at the time when you perform an in-place restore.\n\nBefore you begin\n\nWe recommend completing the following steps before starting the in-place restore\nprocess:\n\n1. [Export the data](/docs/firestore/enterprise/export-import#export_data) in the database you will delete.\n\n If you need to recover the deleted database,\n [import](/docs/firestore/enterprise/export-import#import_data) the data from export operation.\n To recover the deleted database to the same database ID, you must wait until\n any running restore operations complete and then:\n 1. Delete the existing database with the database ID and wait at least 5 minutes\n 2. Create a new database with the database ID\n 3. Start an import operation\n2. Retrieve and copy the index configuration of your database. Export operations\n do not capture index definitions. Use the index configuration to re-create\n indexes after you complete the in-place restore operation. Use the following commands\n to retrieve the index configuration of your database:\n\n - Use [`gcloud firestore indexes composite list`](https://cloud.google.com/sdk/gcloud/reference/firestore/indexes/composite/list)\n to retrieve a list of composite indexes:\n\n gcloud firestore indexes composite list --database=\u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e with the ID of your database.\n - Use [`gcloud firestore indexes fields list`](https://cloud.google.com/sdk/gcloud/reference/firestore/indexes/fields/list)\n to retrieve a list of single-field (built-in) index exemptions.\n\n gcloud firestore indexes fields list --database=\u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e\n\nPerform an in-place restore\n\nComplete the following steps to perform an in-place restore operation. This process\nrequires downtime between the moment you delete the database and when the\nrestore operation completes.\n\nOnce a restore operation begins, you cannot cancel the operation and must wait\nuntil the operation completes. The restore operation immediately occupies the\ndatabase ID used in the operation.\n\n1. Use the [`gcloud firestore backups list`](https://cloud.google.com/sdk/gcloud/reference/firestore/backups/list) command to identify the backup to use\n for the restore operation and note the resource name. The resource name uses\n the following format:\n\n projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID\n\n2. Use the `gcloud firestore databases delete` command to delete the existing\n database:\n\n gcloud firestore databases delete --database='\u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e'\n\n Replace \u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e with the database ID.\n3. Wait at least 5 minutes after you delete the database for the database ID\n to become available again. Initiate a restore operation using the\n [`gcloud firestore databases restore`](https://cloud.google.com/sdk/gcloud/reference/firestore/databases/restore)\n command:\n\n gcloud firestore databases restore \\\n --source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \\\n --destination-database='\u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e'\n\n Replace \u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e with the database ID.\n\nWhat's next\n\n- [Learn more about backup schedules and restore operations](/docs/firestore/enterprise/backups)\n- [Learn about configuring point-in-time recovery (PITR)](/docs/firestore/enterprise/pitr)"]]
