تصدير واستيراد البيانات

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

تصف هذه الصفحة كيفية تصدير واستيراد مستندات Cloud Firestore باستخدام خدمة التصدير والاستيراد المُدارة والتخزين السحابي . تتوفر خدمة التصدير والاستيراد المُدارة في Cloud Firestore من خلال أداة سطر أوامر gcloud و Cloud Firestore API ( REST ، RPC ).

قبل ان تبدأ

قبل أن تتمكن من استخدام خدمة التصدير والاستيراد المُدارة ، يجب عليك إكمال المهام التالية:

  1. تمكين الفوترة لمشروع Google Cloud الخاص بك. يمكن فقط لمشروعات Google Cloud مع تمكين الفوترة استخدام وظائف التصدير والاستيراد.
  2. أنشئ حاوية تخزين سحابي لمشروعك في موقع بالقرب من موقع قاعدة بيانات Cloud Firestore . لا يمكنك استخدام حاوية الطالب يدفع لعمليات التصدير والاستيراد.
  3. تأكد من أن حسابك لديه الأذونات اللازمة لـ Cloud Firestore و Cloud Storage. إذا كنت مالك المشروع ، فإن حسابك لديه الأذونات المطلوبة. بخلاف ذلك ، تمنح الأدوار التالية الأذونات اللازمة لعمليات التصدير والاستيراد وللوصول إلى التخزين السحابي:

أذونات حساب الخدمة الافتراضية

ينشئ كل مشروع من مشروعات Google Cloud تلقائيًا حساب خدمة افتراضيًا باسم PROJECT_ID @appspot.gserviceaccount.com . تستخدم عمليات التصدير والاستيراد حساب الخدمة هذا لتفويض عمليات التخزين السحابي.

يتطلب حساب الخدمة الافتراضي لمشروعك الوصول إلى حاوية Cloud Storage المستخدمة في عملية التصدير أو الاستيراد. إذا كانت حاوية Cloud Storage الخاصة بك في نفس المشروع مثل قاعدة بيانات Cloud Firestore ، فإن حساب الخدمة الافتراضي لديه حق الوصول إلى الحاوية افتراضيًا .

إذا كانت حاوية التخزين السحابي موجودة في مشروع آخر ، فيجب عليك منح حساب الخدمة الافتراضي حق الوصول إلى حاوية التخزين السحابي.

يحتاج حساب الخدمة إلى دور Storage Admin التخزين لحاوية التخزين السحابي ليتم استخدامه لعملية التصدير أو الاستيراد.

إذا قمت بتعطيل حساب خدمة App Engine الافتراضي أو حذفه ، فسيفقد تطبيق App Engine الوصول إلى قاعدة بيانات Cloud Firestore. إذا قمت بتعطيل حساب خدمة App Engine الخاص بك ، فيمكنك إعادة تمكينه ، انظر تمكين حساب الخدمة . إذا حذفت حساب خدمة App Engine خلال آخر 30 يومًا ، فيمكنك استعادة حساب الخدمة الخاص بك ، انظر إلغاء حذف حساب الخدمة .

قم بإعداد gcloud لمشروعك

يمكنك بدء عمليات الاستيراد والتصدير من خلال Google Cloud Platform Console أو أداة سطر أوامر gcloud . لاستخدام gcloud ، قم بإعداد أداة سطر الأوامر والاتصال بمشروعك بإحدى الطرق التالية:

تصدير البيانات

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

تصدير كافة المستندات

جوجل كلاود كونسول

  1. انتقل إلى صفحة Cloud Firestore Import / Export في وحدة تحكم Google Cloud Platform.

    انتقل إلى صفحة الاستيراد / التصدير

  2. انقر فوق تصدير .

  3. انقر فوق خيار تصدير قاعدة البيانات بالكامل .

  4. أدناه اختر الوجهة ، أدخل اسم حاوية التخزين السحابي أو استخدم زر تصفح لتحديد حاوية.

  5. انقر فوق تصدير .

تعود وحدة التحكم إلى صفحة الاستيراد / التصدير . إذا بدأت العملية بنجاح ، تضيف الصفحة إدخالاً إلى صفحة عمليات الاستيراد والتصدير الأخيرة. عند الفشل ، تعرض الصفحة رسالة خطأ.

gcloud

استخدم أمر firestore export جميع المستندات في قاعدة البيانات الخاصة بك ، مع استبدال [BUCKET_NAME] التخزين السحابي. أضف علامة --async لمنع أداة gcloud من انتظار اكتمال العملية.

gcloud firestore export gs://[BUCKET_NAME]

يمكنك تنظيم عمليات التصدير الخاصة بك عن طريق إضافة بادئة ملف بعد اسم المجموعة ، على سبيل المثال ، BUCKET_NAME/my-exports-folder/export-name . إذا لم تقم بتوفير بادئة ملف ، تقوم خدمة التصدير المُدارة بإنشاء واحدة بناءً على الطابع الزمني الحالي.

بمجرد بدء عملية التصدير ، لا يؤدي إغلاق الجهاز إلى إلغاء العملية ، انظر إلغاء العملية .

مجموعات تصدير محددة

جوجل كلاود كونسول

  1. انتقل إلى صفحة Cloud Firestore Import / Export في وحدة تحكم Google Cloud Platform.

    انتقل إلى صفحة الاستيراد / التصدير

  2. انقر فوق تصدير .

  3. انقر فوق خيار تصدير مجموعة مجموعات واحدة أو أكثر . استخدم القائمة المنسدلة لتحديد مجموعة مجموعات واحدة أو أكثر.

  4. أدناه اختر الوجهة ، أدخل اسم حاوية التخزين السحابي أو استخدم زر تصفح لتحديد حاوية.

  5. انقر فوق تصدير .

تعود وحدة التحكم إلى صفحة الاستيراد / التصدير . إذا بدأت العملية بنجاح ، تضيف الصفحة إدخالاً إلى صفحة عمليات الاستيراد والتصدير الأخيرة. عند الفشل ، تعرض الصفحة رسالة خطأ.

gcloud

لتصدير مجموعات مجموعات معينة ، استخدم علامة --collection-ids . تصدر العملية فقط مجموعات المجموعات بمعرفات المجموعة المحددة. تتضمن مجموعة المجموعات جميع المجموعات والمجموعات الفرعية (في أي مسار) بمعرف المجموعة المحدد.

gcloud firestore export gs://[BUCKET_NAME] --collection-ids=[COLLECTION_ID_1],[COLLECTION_ID_2],[SUBCOLLECTION_ID_1]

بيانات الاستيراد

بمجرد تصدير الملفات في Cloud Storage ، يمكنك استيراد المستندات الموجودة في هذه الملفات مرة أخرى إلى مشروعك أو إلى مشروع آخر. لاحظ النقاط التالية حول عمليات الاستيراد:

  • عند استيراد البيانات ، يتم تحديث الفهارس المطلوبة باستخدام تعريفات الفهرس الحالية لقاعدة البيانات الخاصة بك. لا يحتوي التصدير على تعريفات الفهرس.

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

  • إذا لم يتأثر المستند الموجود في قاعدة البيانات بعملية الاستيراد ، فسيظل في قاعدة البيانات الخاصة بك بعد الاستيراد.

  • لا تؤدي عمليات الاستيراد إلى تشغيل وظائف السحابة. مستمعي اللقطات يتلقون التحديثات المتعلقة بعمليات الاستيراد.

  • يجب أن يتطابق اسم الملف .overall_export_metadata مع اسم المجلد الأصل:

    gs://BUCKET_NAME/OPTIONAL_NAMESPACE_PATH/ PARENT_FOLDER_NAME / PARENT_FOLDER_NAME .overall_export_metadata

    إذا قمت بنقل أو نسخ ملفات الإخراج الخاصة بالتصدير ، فاحتفظ باسم ملف PARENT_FOLDER_NAME و .overall_export_metadata كما هو.

قم باستيراد كافة المستندات من عملية تصدير

جوجل كلاود كونسول

  1. انتقل إلى صفحة Cloud Firestore Import / Export في وحدة تحكم Google Cloud Platform.

    انتقل إلى صفحة الاستيراد / التصدير

  2. انقر فوق استيراد .

  3. في حقل اسم الملف ، أدخل اسم الملف لملف .overall_export_metadata من عملية تصدير مكتملة. يمكنك استخدام الزر " استعراض " لمساعدتك في تحديد الملف.

  4. انقر فوق استيراد .

تعود وحدة التحكم إلى صفحة الاستيراد / التصدير . إذا بدأت العملية بنجاح ، تضيف الصفحة إدخالاً إلى صفحة عمليات الاستيراد والتصدير الأخيرة. عند الفشل ، تعرض الصفحة رسالة خطأ.

gcloud

استخدم الأمر firestore import لاستيراد المستندات من عملية تصدير سابقة.

gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/

حيث [BUCKET_NAME] و [EXPORT_PREFIX] إلى موقع ملفات التصدير. علي سبيل المثال:

gcloud firestore import gs://exports-bucket/2017-05-25T23:54:39_76544/

يمكنك تأكيد موقع ملفات التصدير في متصفح Cloud Storage في Google Cloud Platform Console:

افتح متصفح Cloud Storage

بمجرد بدء عملية الاستيراد ، لا يؤدي إغلاق الجهاز الطرفي إلى إلغاء العملية ، انظر إلغاء العملية .

استيراد مجموعات محددة

جوجل كلاود كونسول

لا يمكنك تحديد مجموعات محددة في وحدة التحكم. استخدم gcloud بدلاً من ذلك.

gcloud

لاستيراد مجموعات مجموعات محددة من مجموعة من ملفات التصدير ، استخدم علامة --collection-ids . تستورد العملية فقط مجموعات المجموعة بمعرفات المجموعة المحددة. تتضمن مجموعة المجموعات جميع المجموعات والمجموعات الفرعية (في أي مسار) بمعرف المجموعة المحدد.

يدعم تصدير مجموعات مجموعات محددة فقط استيراد مجموعات مجموعات معينة. لا يمكنك استيراد مجموعات محددة من تصدير كافة المستندات.

gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ --collection-ids=[COLLECTION_ID_1],[COLLECTION_ID_2],[SUBCOLLECTION_ID_1]

إدارة عمليات التصدير والاستيراد

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

تكون أسماء العمليات مسبوقة projects/[PROJECT_ID]/databases/(default)/operations/ ، على سبيل المثال:

projects/my-project/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg

ومع ذلك ، يمكنك استبعاد البادئة عند تحديد اسم عملية لأوامر describe cancel delete .

قائمة بجميع عمليات التصدير والاستيراد

جوجل كلاود كونسول

يمكنك عرض قائمة بعمليات التصدير والاستيراد الأخيرة في صفحة Cloud Firestore Import / Export في Google Cloud Platform Console.

انتقل إلى صفحة الاستيراد / التصدير

gcloud

استخدم أمر operations list لرؤية جميع عمليات التصدير والاستيراد الجارية والتي اكتملت مؤخرًا:

gcloud firestore operations list

تحقق من حالة العملية

جوجل كلاود كونسول

يمكنك عرض حالة عملية تصدير أو استيراد حديثة في صفحة Cloud Firestore Import / Export في Google Cloud Platform Console.

انتقل إلى صفحة الاستيراد / التصدير

gcloud

استخدم أمر operations describe لإظهار حالة عملية التصدير أو الاستيراد.

gcloud firestore operations describe [OPERATION_NAME]

تقدير وقت الانتهاء

يُرجع طلب حالة عملية التشغيل الطويلة عمل المقاييس workEstimated والعمل workCompleted . يتم عرض كل من هذه المقاييس بعدد وحدات البايت وعدد الكيانات:

  • workEstimated يظهر العدد الإجمالي المقدر للبايت والمستندات التي ستعالجها العملية.

  • يعرض workCompleted عدد البايت والمستندات التي تمت معالجتها حتى الآن. بعد اكتمال العملية ، تُظهر القيمة العدد الإجمالي للبايتات والمستندات التي تمت معالجتها بالفعل ، والتي قد تكون أكبر من قيمة العمل workEstimated .

workCompleted حسب workEstimated تقريبي للتقدم. قد يكون هذا التقدير غير دقيق ، لأنه يعتمد على تأخر جمع الإحصائيات.

إلغاء عملية

جوجل كلاود كونسول

يمكنك إلغاء عملية تصدير أو استيراد جارية في صفحة Cloud Firestore Import / Export في Google Cloud Platform Console.

انتقل إلى صفحة الاستيراد / التصدير

في جدول عمليات الاستيراد والتصدير الأخيرة ، تتضمن العمليات الجارية حاليًا زر إلغاء في العمود مكتمل . انقر فوق الزر " إلغاء الأمر" لإيقاف العملية. يتغير الزر إلى رسالة إلغاء ثم إلى ملغى عندما تتوقف العملية تمامًا.

gcloud

استخدم أمر operations cancel لإيقاف عملية قيد التقدم:

gcloud firestore operations cancel [OPERATION_NAME]

لا يؤدي إلغاء عملية جارية إلى التراجع عن هذه العملية. ستترك عملية التصدير الملغاة المستندات التي تم تصديرها بالفعل في Cloud Storage ، وستترك عملية الاستيراد الملغاة التحديثات التي تم إجراؤها بالفعل على قاعدة البيانات الخاصة بك. لا يمكنك استيراد تصدير مكتمل جزئيًا.

حذف عملية

استخدم الأمر gcloud firestore operations delete لإزالة عملية من قائمة العمليات الأخيرة. لن يحذف هذا الأمر ملفات التصدير من التخزين السحابي.

gcloud firestore operations delete [OPERATION_NAME]

الفواتير والتسعير لعمليات التصدير والاستيراد

أنت مطالب بتمكين الفوترة لمشروع Google Cloud قبل استخدام خدمة التصدير والاستيراد المُدارة. يتم فرض رسوم على عمليات التصدير والاستيراد مقابل قراءة المستندات وكتابتها بالمعدلات المدرجة في تسعير Cloud Firestore .

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

عرض تكاليف التصدير والاستيراد

تطبق عمليات التصدير والاستيراد علامة goog-firestoremanaged:exportimport على عمليات الفوترة. في صفحة تقارير Cloud Billing ، يمكنك استخدام هذا التصنيف لعرض التكاليف المتعلقة بعمليات الاستيراد والتصدير:

قم بالوصول إلى تصنيف goog-firestormanaged من قائمة الفلاتر.

تصدير إلى BigQuery

يمكنك تحميل البيانات من تصدير Cloud Firestore إلى BigQuery ، ولكن فقط إذا حددت عامل تصفية collection-ids . راجع تحميل البيانات من عمليات تصدير Cloud Firestore .

حد عمود BigQuery

يفرض BigQuery حدًا يبلغ 10000 عمود لكل جدول. تنشئ عمليات تصدير Cloud Firestore مخطط جدول BigQuery لكل مجموعة تجميع. في هذا المخطط ، يصبح كل اسم حقل فريد داخل مجموعة مجموعة عمود مخطط.

إذا تجاوز مخطط BigQuery لمجموعة المجموعات 10000 عمود ، فإن عملية تصدير Cloud Firestore تحاول البقاء تحت حد العمود من خلال التعامل مع حقول الخريطة على أنها وحدات بايت. إذا أدى هذا التحويل إلى جعل عدد الأعمدة أقل من 10000 ، يمكنك تحميل البيانات في BigQuery ، ولكن لا يمكنك الاستعلام عن الحقول الفرعية داخل حقول الخريطة. إذا كان عدد الأعمدة لا يزال يتجاوز 10000 ، فإن عملية التصدير لا تنشئ مخطط BigQuery لمجموعة المجموعة ولا يمكنك تحميل بياناتها في BigQuery.

تصدير ملفات البيانات الوصفية وتنسيقها

يستخدم إخراج التصدير المُدار تنسيق سجل LevelDB .

ملفات البيانات الوصفية

تنشئ عملية التصدير ملف بيانات أولية لكل مجموعة مجموعات تحددها. عادةً ما يتم تسمية ملفات البيانات الوصفية ALL_NAMESPACES_KIND_[COLLECTION_GROUP_ID].export_metadata .

ملفات البيانات الوصفية عبارة عن مخازن مؤقتة للبروتوكول ويمكنك فك تشفيرها باستخدام برنامج protoc البرمجي للبروتوكول . على سبيل المثال ، يمكنك فك تشفير ملف بيانات أولية لتحديد مجموعات المجموعات التي تحتوي عليها ملفات التصدير:

protoc --decode_raw < export0.export_metadata

ترحيل وكيل الخدمة

يمكنك الآن استخدام وكيل خدمة Cloud Firestore لتفويض عمليات الاستيراد والتصدير بدلاً من حساب خدمة App Engine. يستخدم حساب وكيل الخدمة والخدمة اصطلاحات التسمية التالية:

وكيل خدمة Cloud Firestore
service- project_number @gcp-sa-firestore.iam.gserviceaccount.com
حساب خدمة App Engine
project_id @appspot.gserviceaccount.com

يُفضل وكيل خدمة Cloud Firestore لأنه خاص بـ Cloud Firestore. يتم مشاركة حساب خدمة App Engine بواسطة أكثر من خدمة واحدة.

عرض حساب التفويض

يمكنك عرض الحساب الذي تستخدمه عمليات الاستيراد والتصدير لتفويض الطلبات من صفحة الاستيراد / التصدير في وحدة تحكم Google Cloud Platform. يمكنك أيضًا عرض ما إذا كانت قاعدة البيانات الخاصة بك تستخدم بالفعل وكيل خدمة Cloud Firestore.

  1. انتقل إلى صفحة Cloud Firestore Import / Export في وحدة تحكم Google Cloud Platform.

    انتقل إلى استيراد / تصدير

  2. اعرض حساب التفويض بجوار وظائف الاستيراد / التصدير التي تعمل كتسمية.

إذا كان مشروعك لا يستخدم وكيل خدمة Cloud Firestore ، فيمكنك الترحيل إلى وكيل خدمة Cloud Firestore باستخدام أي من الأساليب التالية:

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

يمكنك الترحيل عن طريق التحقق من أذونات حاوية التخزين السحابي وتحديثها

تتكون عملية الترحيل من خطوتين:

  1. تحديث أذونات حاوية التخزين السحابي. انظر القسم التالي للحصول على التفاصيل.
  2. قم بتأكيد الترحيل إلى وكيل خدمة Cloud Firestore.

أذونات حزمة وكيل الخدمة

بالنسبة إلى أي عمليات تصدير أو استيراد تستخدم حاوية Cloud Storage في مشروع آخر ، يجب عليك منح أذونات وكيل خدمة Cloud Firestore لتلك المجموعة. على سبيل المثال ، تحتاج العمليات التي تنقل البيانات إلى مشروع آخر إلى الوصول إلى حاوية في هذا المشروع الآخر. وبخلاف ذلك ، تفشل هذه العمليات بعد الترحيل إلى وكيل خدمة Cloud Firestore.

لا يتطلب استيراد وتصدير مهام سير العمل التي تبقى ضمن نفس المشروع تغييرات على الأذونات. يمكن لوكيل خدمة Cloud Firestore الوصول إلى الحاويات في نفس المشروع افتراضيًا.

قم بتحديث أذونات حاويات التخزين السحابي من مشاريع أخرى لمنح حق الوصول إلى وكيل خدمة service- project_number @gcp-sa-firestore.iam.gserviceaccount.com . امنح وكيل الخدمة دور Firestore Service Agent .

يمنح دور Firestore Service Agent أذونات القراءة والكتابة لحاوية التخزين السحابي. إذا كنت بحاجة إلى منح أذونات القراءة فقط أو أذونات الكتابة فقط ، فاستخدم دورًا مخصصًا .

تساعدك عملية الترحيل الموضحة في القسم التالي على تحديد حاويات التخزين السحابي التي قد تتطلب تحديثات الأذونات.

قم بترحيل مشروع إلى وكيل خدمة Firestore

أكمل الخطوات التالية للترحيل من حساب خدمة App Engine إلى وكيل خدمة Cloud Firestore. بمجرد الانتهاء ، لا يمكن التراجع عن الترحيل.

  1. انتقل إلى صفحة Cloud Firestore Import / Export في وحدة تحكم Google Cloud Platform.

    انتقل إلى استيراد / تصدير

  2. إذا لم يتم ترحيل مشروعك بعد إلى وكيل خدمة Cloud Firestore ، فسترى لافتة تصف الترحيل وزر التحقق من حالة الحاوية . تساعدك الخطوة التالية في تحديد أخطاء الأذونات المحتملة وإصلاحها.

    انقر فوق التحقق من حالة الحاوية .

    تظهر قائمة بها خيار إكمال الترحيل وقائمة بحاويات التخزين السحابي. قد يستغرق تحميل القائمة بضع دقائق.

    تتضمن هذه القائمة الحاويات التي تم استخدامها مؤخرًا في عمليات الاستيراد والتصدير ، ولكنها لا تمنح حاليًا أذونات القراءة والكتابة إلى وكيل خدمة Cloud Firestore.

  3. قم بتدوين الاسم الرئيسي لوكيل خدمة Cloud Firestore الخاص بمشروعك. يظهر اسم وكيل الخدمة أسفل وكيل الخدمة لمنح حق الوصول إلى التسمية.
  4. بالنسبة إلى أي مجموعة في القائمة ستستخدمها لعمليات الاستيراد أو التصدير المستقبلية ، أكمل الخطوات التالية:

    1. في صف جدول هذه المجموعة ، انقر فوق إصلاح . يؤدي هذا إلى فتح صفحة أذونات الحاوية في علامة تبويب جديدة.

    2. انقر فوق إضافة .
    3. في حقل المبادئ الجديدة ، أدخل اسم وكيل خدمة Cloud Firestore الخاص بك.
    4. في الحقل تحديد دور ، حدد وكلاء الخدمة> وكيل خدمة Firestore .
    5. انقر فوق حفظ .
    6. ارجع إلى علامة التبويب مع صفحة Cloud Firestore Import / Export.
    7. كرر هذه الخطوات مع المستودعات الأخرى في القائمة. تأكد من عرض جميع صفحات القائمة.
  5. انقر فوق ترحيل إلى وكيل خدمة Firestore . إذا كان لا يزال لديك حاويات بها عمليات التحقق من الأذونات الفاشلة ، فأنت بحاجة إلى تأكيد الترحيل الخاص بك عن طريق النقر فوق ترحيل .

    يعلمك تنبيه عند اكتمال الترحيل. لا يمكن التراجع عن الترحيل.

عرض حالة الترحيل

  1. للتحقق من حالة ترحيل مشروعك ، انتقل إلى صفحة الاستيراد / التصدير في وحدة تحكم Google Cloud Platform:

    انتقل إلى استيراد / تصدير

  2. ابحث عن العنصر الأساسي الموجود بجوار وظائف الاستيراد / التصدير التي يتم تشغيلها كتسمية.

    إذا كان المدير هو service- project_number @gcp-sa-firestore.iam.gserviceaccount.com ، فهذا يعني أنه تم ترحيل مشروعك بالفعل إلى وكيل خدمة Cloud Firestore. لا يمكن التراجع عن الترحيل.

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

قم بإضافة قيد سياسة على مستوى المؤسسة

  • قم بتعيين القيد التالي في سياسة مؤسستك:

    طلب وكيل خدمة Firestore للاستيراد / التصدير ( firestore.requireP4SAforImportExport ).

    يتطلب هذا القيد عمليات الاستيراد والتصدير لاستخدام وكيل خدمة Cloud Firestore لتفويض الطلبات. لتعيين هذا القيد ، راجع إنشاء سياسات المؤسسة وإدارتها .

لا يمنح تطبيق قيد السياسة التنظيمية هذا أذونات حاوية Cloud Storage المناسبة لوكيل خدمة Cloud Firestore تلقائيًا.

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