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

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

توضّح هذه الصفحة كيفية تصدير وتصدير مستندات Cloud Firestore باستخدام خدمة التصدير والاستيراد المُدارة وCloud Storage. تتوفّر خدمة التصدير والاستيراد المُدارة في Cloud Firestore من خلال أداة سطر أوامر gcloud وCloud Firestore واجهة برمجة التطبيقات (REST وRPC).

ملاحظة: سيؤدي تصدير البيانات من Cloud Firestore إلى إجراء عملية قراءة واحدة لكل مستند يتم تصديره. ومع ذلك، لن تظهر عمليات القراءة هذه في قسم "الاستخدام" في وحدة التحكّم. يُرجى الحرص على فهم ذلك قبل إعداد عمليات التصدير المتكرّرة لتجنُّب تلقّي فاتورة غير متوقّعة.

قبل البدء

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

1. فعِّل الفوترة لمشروعك على "Google Cloud". لا يمكن استخدام وظيفة التصدير والاستيراد إلا في Google Cloud المشاريع التي تم تفعيل الفوترة فيها.
   ملاحظة: يجب أن تكون مشاريع Firebase ضمن خطة Blaze تعمل Google Cloud على ترقية مشروع Firebase تلقائيًا إلى خطة Blaze.
2. أنشئ حزمة Cloud Storage لمشروعك في موقع جغرافي قريب من موقع جغرافي Cloud Firestore لقاعدة بياناتك. لا يمكنك استخدام حزمة "يدفع مقدّم الطلب" لعمليات التصدير والاستيراد.

3. تأكَّد من أنّ حسابك يتضمّن الأذونات اللازمة لتطبيق Cloud Firestore وCloud Storage. إذا كنت مالك المشروع، سيتوفّر لحسابك الأذونات المطلوبة. بخلاف ذلك، تمنحك الأدوار التالية الأذونات اللازمة لإجراء عمليات التصدير والاستيراد وللوصول إلى Cloud Storage:

   • أدوار Cloud Firestore: Owner أو Cloud Datastore Owner أو Cloud Datastore Import Export Admin
     ملاحظة: تمنح أدوار Datastore هذه أيضًا الأذونات في Cloud Firestore.

   • أدوار Cloud Storage: Owner أو Storage Admin

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

تستخدِم عمليات التصدير والاستيراد وكيل خدمة Cloud Firestore لمنح الإذن بعمليات Cloud Storage. يستخدم موظّف خدمة Cloud Firestore اتفاقية التسمية التالية:

موظّف خدمة Cloud Firestore

[e-mail]

لمزيد من المعلومات حول موظّفي الدعم، يُرجى الاطّلاع على مقالة وكلاء الصيانة.

ملاحظة: كان Cloud Firestore يستخدم في السابق حساب الخدمة التلقائي App Engine بدلاً من وكيل الخدمة Cloud Firestore. إذا كانت قاعدة البيانات لا تزال تستخدم حساب خدمة App Engine لاستيراد البيانات أو تصديرها، ننصحك بنقل البيانات إلى وكيل خدمة Cloud Firestore الخاص بالخدمة. يمكنك الاطّلاع على الحساب الذي تستخدمه عمليات الاستيراد والتصدير في وحدة تحكّم Google Cloud.

إذا كنت تستخدم عناصر التحكّم في خدمة سحابة VPC، يجب استخدام وكيل الخدمة Cloud Firestore الخاص بالخدمة لحماية عمليات الوارد والصادر بالكامل. لا تتوافق عناصر التحكّم في خدمة سحابة VPC مع حساب الخدمة App Engine.

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

إذا كانت حزمة Cloud Storage في مشروع آخر، يجب منح موظّف خدمة Cloud Firestore إذن الوصول إلى حزمة Cloud Storage .

منح أدوار لوكيل الخدمة

يمكنك استخدام أداة سطر الأوامر gsutil لتحديد أحد الأدوار أدناه. على سبيل المثال، لتعيين دور "مشرف مساحة التخزين" إلى موظّف خدمة Cloud Firestore، نفِّذ ما يلي:

gsutil iam ch serviceAccount:[e-mail]:roles/storage.admin \
    gs://[BUCKET_NAME]

استبدِل PROJECT_NUMBER برقم مشروعك الذي يُستخدَم لتسمية موظّف الدعم Cloud Firestore. لعرض اسم وكيل الخدمة، يُرجى الاطّلاع على عرض اسم وكيل الخدمة.

بدلاً من ذلك، يمكنك منح هذا الدور باستخدام وحدة تحكُّم Google Cloud.

عرض اسم موظّف الدعم

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

1. اطّلِع على حساب التفويض بجانب التصنيف عمليات الاستيراد/التصدير التي يتم تنفيذها باسم.

يحتاج موظّف الدعم إلى دور Storage Admin في حزمة Cloud Storage لاستخدامها في عملية التصدير أو الاستيراد.

إعداد ميزة "gcloud" لمشروعك

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

• يمكنك الوصول إلى gcloud من وحدة تحكّم Google Cloud Platform باستخدام Cloud Shell.

  بدء Cloud Shell

  تأكَّد من ضبط gcloud للمشروع الصحيح:

  gcloud config set project [PROJECT_ID]
  

• ثبِّت حزمة Google Cloud SDK واضبطها.

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

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

ملاحظة: يجب تصدير مجموعات معيّنة إذا كنت تخطّط لإجراء ما يلي:

• استيراد مجموعات معيّنة فقط
• تحميل بيانات Cloud Firestore إلى BigQuery

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

Google Cloud Console

1. في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة قواعد البيانات.

   الانتقال إلى قواعد البيانات

2. اختَر قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

3. في قائمة التنقّل، انقر على استيراد/تصدير.

4. انقر على تصدير.

5. انقر على الخيار تصدير قاعدة البيانات بالكامل.

6. أسفل اختيار الوجهة، أدخِل اسم حزمة Cloud Storage أو استخدِم الزر تصفّح لاختيار حزمة.

7. انقر على تصدير.

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

gcloud

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

  gcloud firestore export gs://[BUCKET_NAME] \
  --database=[DATABASE]

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

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

• DATABASE: اسم قاعدة البيانات التي تريد تصدير المستندات منها بالنسبة إلى قاعدة البيانات التلقائية، استخدِم --database='(default)'.

بعد بدء عملية تصدير، لا يؤدي إغلاق المحطة إلى إلغاء العملية، راجِع إلغاء عملية.

تصدير مجموعات معيّنة

Google Cloud Console

1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة القواعد البيانات.

   الانتقال إلى قواعد البيانات

2. اختَر قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

3. في قائمة التنقّل، انقر على استيراد/تصدير.

4. انقر على تصدير.

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

6. في أسفل اختيار الوجهة، أدخِل اسم حزمة Cloud Storage أو استخدِم الزر تصفّح لاختيار حزمة.

7. انقر على تصدير.

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

gcloud

لتصدير مجموعات مجموعات معيّنة، استخدِم العلامة --collection-ids. لا تُصدِّر العملية سوى مجموعات المجموعات التي تتضمّن معرّفات المجموعات المحدّدة. وتشمل مجموعة المجموعات جميع المجموعات والمجموعات الفرعية (في أي مسار) بمعرّف المجموعة المحدّد.

ملاحظة: لن يؤدي تصدير مجموعة إلى تصدير مجموعاتها الفرعية تلقائيًا. وعليك أيضًا تحديد المجموعات الفرعية المطلوب تصديرها.

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

على سبيل المثال، يمكنك تصميم مجموعة restaurants في قاعدة بيانات foo لتضمين عدة مجموعات فرعية، مثل ratings أو reviews أو outlets. لتصدير مجموعتَي restaurants وreviews المحدّدتين، سيظهر الأمر على النحو التالي:

gcloud firestore export gs://[BUCKET_NAME] \
--collection-ids=restaurants,reviews \
--database='cymbal'

التصدير من الطابع الزمني لـ PITR

يمكنك تصدير قاعدة بياناتك إلى Cloud Storage من بيانات PITR باستخدام الأمر gcloud firestore export. يمكنك تصدير بيانات PITR التي يكون الطابع الزمني فيها هو طابع زمني كاملاً للدقيقة خلال الأيام السبعة الماضية، ولكن ليس قبل ‎earliestVersionTime. إذا لم تعد البيانات متوفّرة في الطابع الزمني المحدّد، ستتعذّر عملية التصدير.

تتيح عملية تصدير PITR جميع الفلاتر، بما في ذلك تصدير جميع المستندات وتصدير مجموعات معيّنة.

1. تصدِّر قاعدة البيانات، مع تحديد المَعلمة snapshot-time على الطابع الزمني المطلوب للاسترداد.

   gcloud

   نفِّذ الأمر التالي لتصدير قاعدة البيانات إلى حزمة التخزين.

   gcloud firestore export gs://[BUCKET_NAME_PATH] \
       --snapshot-time=[PITR_TIMESTAMP] \
       --collection-ids=[COLLECTION_IDS] \
       --namespace-ids=[NAMESPACE_IDS]
   

   مع أطيب التحيّات،

   • PITR_TIMESTAMP - طابع زمني لـ PITR بدقة دقيقة، على سبيل المثال 2023-05-26T10:20:00.00Z.

   يُرجى مراعاة النقاط التالية قبل تصدير بيانات PITR:

   • حدِّد الطابع الزمني بتنسيق RFC 3339 . على سبيل المثال، 2020-09-01T23:59:30.234233Z.
   • تأكَّد من أنّ الطابع الزمني الذي تحدّده هو طابع زمني كامل للدقيقة خلال آخر سبعة أيام، ولكن ليس قبل earliestVersionTime. إذا لم تعُد البيانات متوفّرة في الطابع الزمني المحدّد، يتمّ إنشاء خطأ.
   • لا يتم تحصيل رسوم منك مقابل عملية تصدير PITR تعذّرت.

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

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

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

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

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

• لا تؤدي عمليات الاستيراد إلى تشغيل Cloud Functions. يتلقى مستمع اللقطة تحديثات ذات صلة بعمليات الاستيراد.

• يجب أن يتطابق اسم ملف .overall_export_metadata مع اسم ملفه родительским المهمّ:

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

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

استيراد جميع المستندات من عملية تصدير

Google Cloud Console

1. في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة قواعد البيانات.

   الانتقال إلى قواعد البيانات

2. حدد قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

3. في قائمة التنقّل، انقر على استيراد/تصدير.

4. انقر على استيراد.

5. في حقل اسم الملف، أدخِل اسم ملف .overall_export_metadata من عملية تصدير مكتملة. يمكنك استخدام الزر تصفّح لمساعدتك في اختيار الملف.

6. انقر على استيراد.

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

gcloud

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

gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ --database=[DATABASE]

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

• BUCKET_NAME/EXPORT_PREFIX: موقع ملفات التصدير

• DATABASE: اسم قاعدة البيانات بالنسبة إلى قاعدة البيانات التلقائية، استخدِم --database='(default)'.

على سبيل المثال:

gcloud firestore import gs://my-bucket/2017-05-25T23:54:39_76544/ --database='cymbal'

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

فتح متصفّح Cloud Storage

بعد بدء عملية استيراد، لا يؤدي إغلاق المحطة إلى إلغاء العملية، راجِع إلغاء عملية.

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

ملاحظة: لاستيراد مجموعات معيّنة، عليك استخدام ناتج عملية تصدير تم فيها تصدير مجموعات معيّنة.

Google Cloud Console

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

gcloud

لاستيراد مجموعات مجموعات معيّنة من مجموعة من ملفات التصدير، استخدِم العلامة --collection-ids. تستورد العملية مجموعات المجموعات التي تتضمّن معرّفات المجموعات المحدّدة فقط. تتضمّن مجموعة المجموعات جميع المجموعات والمجموعات الفرعية (في أي مسار) التي تحتوي على معرّف المجموعة المحدّد. حدِّد اسم قاعدة البيانات باستخدام العلامة --database . بالنسبة إلى قاعدة البيانات التلقائية، استخدِم --database='(default)'.

لا يتيح تصدير مجموعات مجموعات معيّنة إلا استيراد مجموعات مجموعات معيّنة. لا يمكنك استيراد مجموعات محددة من تصدير جميع المستندات.

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

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

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

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

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

تتم إضافة البادئة projects/[PROJECT_ID]/databases/(default)/operations/ إلى أسماء العمليات، على سبيل المثال:

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

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

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

Google Cloud Console

يمكنك الاطّلاع على قائمة بعمليات التصدير والاستيراد الأخيرة في صفحة الاستيراد/التصدير في Google Cloud Console.

1. في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة قواعد البيانات.

   الانتقال إلى قواعد البيانات

2. حدد قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

3. في قائمة التنقّل، انقر على استيراد/تصدير.

gcloud

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

gcloud firestore operations list

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

Google Cloud Console

يمكنك الاطّلاع على حالة عملية تصدير أو استيراد حديثة في صفحة الاستيراد/التصدير في وحدة تحكّم Google Cloud.

1. في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة قواعد البيانات.

   الانتقال إلى قواعد البيانات

2. حدد قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

3. في قائمة التنقّل، انقر على استيراد/تصدير.

gcloud

استخدِم الأمر operations describe لعرض حالة عملية تصدير أو استيراد.

gcloud firestore operations describe [OPERATION_NAME]

تقدير وقت الإنجاز

يؤدي طلب حالة عملية طويلة إلى عرض المقياسين workEstimated وworkCompleted. يتم عرض كلّ من هذه المقاييس في كلّ من عدد وحدات البايت وعدد الكيانات:

• workEstimated تعرِض إجمالي عدد البايتات والمستندات المقدَّر الذي ستعالجه العملية. قد Cloud Firestore تخطّي هذا المقياس إذا تعذّر عليه إجراء تقدير.

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

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

إلغاء عملية

Google Cloud Console

يمكنك إلغاء عملية تصدير أو استيراد قيد التشغيل في صفحة الاستيراد/التصدير على وحدة التحكّم في Google Cloud.

1. في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة قواعد البيانات.

   الانتقال إلى قواعد البيانات

2. اختَر قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

3. في قائمة التنقّل، انقر على استيراد/تصدير.

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

gcloud

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

gcloud firestore operations cancel [OPERATION_NAME]

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

حذف عملية

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

gcloud firestore operations delete [OPERATION_NAME]

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

عليك تفعيل الفوترة لمشروعك على Google Cloud قبل استخدام خدمة التصدير والاستيراد المُدارة.

يتم تحصيل رسوم من عمليات التصدير والاستيراد لقراءة المستندات وكتابتها بالأسعار المدرَجة في أسعار Cloud Firestore. تنطوي عمليات التصدير على عملية قراءة واحدة لكل مستند تم تصديره. تتطلب عمليات الاستيراد عملية كتابة واحدة لكل مستند مستورد.

يتم احتساب ملفات الإخراج المخزّنة في Cloud Storage ضمن تكاليف تخزين بيانات Cloud Storage.

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

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

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

ملاحظة: لم تؤدي عمليات التصدير والاستيراد التي تم تنفيذها قبل 8 أيلول (سبتمبر) 2020 إلى تطبيق التصنيف goog-firestoremanaged.

التصدير إلى BigQuery

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

الحد الأقصى لعدد الأعمدة هو BigQuery

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

إذا تجاوز مخطّط BigQuery لمجموعة المجموعات 10,000 عمود، تحاول عملية Cloud Firestore التصدير البقاء ضمن الحد الأقصى للأعمدة من خلال التعامل مع حقول الخريطة على أنّها وحدات بايت. إذا أدّت عملية التحويل هذه إلى خفض عدد الأعمدة إلى أقل من 10,000، يمكنك تحميل البيانات إلى BigQuery، ولكن لا يمكنك طلب البحث في الحقول الفرعية ضمن حقول الخريطة. إذا كان عدد الأعمدة لا يزال يتجاوز 10,000، لا تؤدي عملية التصدير إلى توليد مخطّط BigQuery لمجموعة المجموعة ولا يمكنك تحميل data إلى BigQuery.

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

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

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

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

ملفات البيانات الوصفية هي وحدات تخزين بروتوكول، ويمكنك فك ترميزها باستخدام protoc مُجمِّع البروتوكول. على سبيل المثال، يمكنك فك ترميز ملف بيانات وصفية لتحديد مجموعات المجموعات التي تحتوي عليها ملفات التصدير:

protoc --decode_raw < export0.export_metadata

نقل وكيل الخدمة

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

موظّف خدمة Cloud Firestore

[e-mail]

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

حساب خدمة واحد (App Engine)

[e-mail]

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

ملاحظة: إذا كنت تستخدم عناصر التحكّم في خدمة سحابة VPC، عليك استخدام وكيل الخدمة Cloud Firestore لحماية عمليات الاستيراد والتصدير بالكامل. لا تتوافق عناصر التحكّم في خدمة سحابة VPC مع حساب الخدمة App Engine.

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

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

1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة القواعد البيانات.

   الانتقال إلى قواعد البيانات

2. حدد قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

3. في قائمة التنقّل، انقر على استيراد/تصدير.

4. اطّلِع على حساب التفويض بجانب التصنيف عمليات الاستيراد/التصدير التي يتم تنفيذها باسم.

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

• نقل بيانات مشروع من خلال التحقّق من أذونات Cloud Storage الحزمة وتعديلها (إجراء يُنصح به)
• إضافة قيد سياسة على مستوى المؤسسة يؤثر في جميع المشاريع ضمن المؤسسة

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

نقل البيانات من خلال التحقّق من أذونات حزمة Cloud Storage وتعديلها

تتكون عملية نقل البيانات من خطوتَين:

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

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

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

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

عدِّل أذونات حِزم Cloud Storage من مشاريع أخرى لمنح العميل إذن بالوصول إلى [e-mail] موظّف الدعم. امنح موظّف الدعم الدور Firestore Service Agent.

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

تساعدك عملية نقل البيانات الموضّحة في القسم التالي في تحديد Cloud Storage الحِزم التي قد تتطلّب تعديلات على الأذونات.

نقل مشروع إلى "وكيل خدمة Firestore"

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

1. في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة قواعد البيانات.

   الانتقال إلى قواعد البيانات

2. اختَر قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

3. في قائمة التنقّل، انقر على استيراد/تصدير.

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

   انقر على التحقّق من حالة الحزمة.

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

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

5. دوِّن الاسم الأساسي لوكيل خدمة Cloud Firestore مشروعك. يظهر اسم موظّف خدمة الدعم ضمن التصنيف موظّف خدمة الدعم الذي سيتم منحه إذن الوصول.

6. بالنسبة إلى أي حزمة في القائمة ستستخدمها لإجراء عمليات استيراد أو تصدير في المستقبل، أكمِل الخطوات التالية:

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

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

7. انقر على نقل البيانات إلى وكيل خدمة Firestore. إذا كان لا يزال لديك حِزم تتضمّن عمليات تحقّق من الأذونات تنتهي بالفشل، عليك تأكيد عملية نقل البيانات بالنقر على نقل البيانات.

   سيصلك تنبيه لإعلامك عند اكتمال عملية نقل البيانات. لا يمكن التراجع عن عملية نقل البيانات.

عرض حالة النقل

للتحقّق من حالة نقل بيانات مشروعك:

1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة القواعد البيانات.

   الانتقال إلى قواعد البيانات

2. اختَر قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

3. في قائمة التنقّل، انقر على استيراد/تصدير.

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

   إذا كان المشرف هو [e-mail]، يعني ذلك أنّه سبق نقل مشروعك إلى Cloud Firestore موظّف خدمة. لا يمكن التراجع عن عملية نقل البيانات.

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

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

• اضبط القيود التالية في سياسة مؤسستك:

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

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

لا يؤدي تطبيق قيد السياسة التنظيمية هذا إلى منح أذونات حزمة Cloud Storage المناسبة تلقائيًا لموظّف خدمة Cloud Firestore.

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