يمكنك استخدام Cloud Firestore خدمة الحذف المجمّع المُدار لحذف البيانات من قاعدة بياناتك. تتيح هذه الميزة حذف مجموعة واحدة أو أكثر من مجموعات المجموعات.
توضّح هذه الصفحة كيفية حذف مستندات Cloud Firestore بشكل مجمّع باستخدام خدمة الحذف المجمّع المُدارة. تتوفّر
خدمة الحذف المجمّع المُدارة منCloud Firestore من خلال
أداة سطر أوامر gcloud
وCloud Firestore
واجهة برمجة التطبيقات (REST وRPC).
قبل البدء
قبل أن تتمكّن من استخدام خدمة "الحذف المجمّع المُدار"، عليك إكمال المهام التالية:
- فعِّل الفوترة لمشروعك على "Google Cloud". لا يمكن استخدام وظيفة الحذف المجمّع إلا في مشاريع Google Cloud التي تم تفعيل الفوترة فيها.
-
تأكَّد من أنّ حسابك يتضمّن الأذونات اللازمة لـ Cloud Firestore. إذا كنت مالك المشروع، سيتوفّر لحسابك الأذونات المطلوبة. بخلاف ذلك، تمنحك الأدوار التالية الأذونات اللازمة لإجراء عمليات الحذف المجمّع:
- أدوار Cloud Firestore:
Owner
أوCloud Datastore Owner
أوCloud Datastore Bulk Admin
- أدوار Cloud Firestore:
إعداد gcloud
لمشروعك
يمكنك بدء عمليات حذف مجمّعة من خلال وحدة تحكّم Google Cloud أو
أداة سطر الأوامر gcloud
. لاستخدام gcloud
، يمكنك إعداد أداة سطر الأوامر
والاتصال بمشروعك بإحدى الطرق التالية:
يمكنك الوصول إلى
gcloud
من وحدة تحكّم Google Cloud باستخدام Cloud Shell.تأكَّد من ضبط
gcloud
للمشروع الصحيح:gcloud config set project [PROJECT_ID]
حذف البيانات بشكلٍ مجمّع
تبحث عملية الحذف المجمّع أولاً عن جميع المستندات السارية في قاعدة بياناتك وتحذفها على دفعات. لا يزال بإمكانك الاستعلام عن هذه المستندات أو قراءتها، بينما قد تختلف النتائج بناءً على التقدم المحرز. لن يؤدي الحذف المجمّع إلى حذف أي مستندات تمت إضافتها أو تعديلها بعد بدء العملية.
حذف مجموعات مجموعات معيّنة بشكل مجمّع
gcloud
لحذف مجموعات مجموعات معيّنة بشكل مجمّع، استخدِم العلامة
--collection-ids
. لا تحذف العملية سوى
مجموعات المجموعات التي تحتوي على المعرّفات المحدّدة. تتضمّن مجموعة المجموعات
جميع المستندات والمستندات المُدمجة (في أي مسار) مع مجموعات المجموعات
المحدّدة.
gcloud beta firestore bulk-delete \ --collection-ids=[COLLECTION_GROUP_ID_1_OR_KIND_1],[COLLECTION_GROUP_ID_2_OR_KIND_2],[SUBCOLLECTION_GROUP_ID_1_OR_KIND_3] \ --database=[DATABASE]
إدارة عمليات الحذف المجمّع
بعد بدء عملية حذف مجمّعة، يحدّد Cloud Firestore اسمًا فريدًا للعملية. يمكنك استخدام اسم العملية لحذف العملية أو إلغاؤها أو التحقق من حالتها.
تتم إضافة البادئة projects/[PROJECT_ID]/databases/[DATABASE_ID]/operations/
إلى أسماء العمليات،
على سبيل المثال:
projects/my-project/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg
ومع ذلك، يمكنك حذف البادئة عند تحديد اسم عملية لسمَتَي describe
وcancel
وdelete
.
سرد جميع عمليات الحذف المجمّع
gcloud
استخدِم الأمر operations list
للاطّلاع على جميع العمليات الجارية والمكتملة مؤخرًا، بما في ذلك عمليات الحذف المجمّع:
gcloud firestore operations list
التحقّق من حالة العملية
gcloud
استخدِم الأمر operations describe
لعرض حالة عملية الحذف المجمّع.
gcloud firestore operations describe [OPERATION_NAME]
تقدير وقت الإنجاز
يؤدي طلب حالة عملية طويلة الأمد إلى عرض المقياسَين
workEstimated
وworkCompleted
. يتم عرض كلّ من هذه المقاييس في كلّ من
عدد وحدات البايت وعدد المستندات:
تعرض الدالة
workEstimated
العدد الإجمالي المقدَّر لوحدات البايت والمستندات التي ستعالجها العملية. قد يحذف Cloud Firestore هذا المقياس إذا لم تتمكّن من تقديره.يعرض
workCompleted
عدد وحدات البايت والمستندات المحذوفة حتى الآن. بعد اكتمال العملية، تعرض القيمة إجمالي عدد البايت والمستندات التي تمت معالجتها فعليًا، وقد يكون أكبر من قيمةworkEstimated
.
اقسم workCompleted
على workEstimated
للحصول على تقدير تقريبي للتقدّم. قد يكون هذا التقدير غير دقيق، لأنّه يعتمد على جمع الإحصاءات متأخّرًا.
إلغاء عملية
gcloud
استخدِم الأمر operations cancel
لإيقاف عملية جارية:
gcloud firestore operations cancel [OPERATION_NAME]
لا يؤدي إلغاء عملية جارية إلى التراجع عن العملية. لن تؤدي عملية إلغاء حذف ملفّات مجمّعة إلى استرداد المستندات المحذوفة.
حذف عملية
استخدِم الأمر gcloud firestore operations delete
لإزالة
عملية مكتملة من قائمة العمليات الأخيرة. لإلغاء عملية جارية، استخدِم عملية الإلغاء السابقة.
gcloud firestore operations delete [OPERATION_NAME]
الفوترة والأسعار لعمليات الحذف المجمّع
عليك تفعيل الفوترة لمشروعك على Google Cloud قبل استخدام خدمة الحذف المجمّع المُدارة.
يتم تحصيل رسوم عمليات الحذف المجمّع مقابل قراءة المستندات وحذفها بالأسعار الواردة في سعر Cloud Firestore. تتطلب عمليات الحذف المجمّع قراءة إدخال فهرس واحد لكل مستند تم العثور عليه وعملية حذف واحدة لكل مستند يتم حذفه. يتم تحصيل رسوم منك مقابل عملية قراءة واحدة لما يصل إلى 1000 إدخال فهرس. على سبيل المثال، إذا أجريت عملية حذف مجمّع وحذفت 1500 مستند، سيتم تحصيل رسوم منك مقابل قراءة مستندَين وحذف 1500 مستند.
يُرجى العِلم أنّ Cloud Firestore تفرض رسومًا على العمل الفعلي الذي تمّ إنجازه. إذا تم إلغاء العملية أو تعذّر إكمالها بسبب خطأ من المستخدم، سيتم تحصيل رسوم منك مقابل التقدّم الذي أحرزته. لن تفرض Cloud Firestore رسومًا مقابل قراءة أو حذف المستندات التي لم يتم حذفها في النهاية (مثل المستندات التي تم تعديلها بعد بدء عملية الحذف). وسيتم تحديد مصدر التكلفة في يوم اكتمال العملية.
لن تؤدي عمليات الحذف المجمّع إلى تشغيل تنبيهات Google Cloud الميزانية إلا بعد اكتمالها. وبالمثل، يتم تطبيق عمليات القراءة والحذف التي يتم إجراؤها أثناء عملية حذف مجمّعة على الحصة المجانية/الاستخدام بعد اكتمال العملية. لن تؤثر عمليات الحذف المجمّع على الاستخدام المعروض في قسم الاستخدام بوحدة التحكم.
عرض تكاليف الحذف المجمّع
تطبِّق عمليات الحذف المجمّعة التصنيف goog-firestoremanaged:bulkdelete
على العمليات التي يتمّ تحصيل رسومها. في صفحة تقارير الفوترة في السحابة الإلكترونية،
يمكنك استخدام هذا التصنيف لعرض التكاليف المرتبطة بعمليات الحذف المجمّع.
أفضل الممارسات
تجنَّب تخطّي البيانات المحذوفة الذي قد يؤدي إلى إبطاء طلبات البحث.