نقل البيانات من إصدار Standard إلى إصدار Enterprise

لنقل البيانات من قاعدة بيانات Firestore Standard إلى قاعدة بيانات Firestore Enterprise، ننصحك باستخدام أحد الخيارات التالية:

  • ميزتا الاستيراد والتصدير تتوافق ملفات البيانات من عملية الاستيراد مع كل من إصدار Enterprise والإصدار Standard.

  • نموذج Dataflow firestore-to-firestore تتيح لك خدمة Dataflow إنشاء مسارات بيانات، وينشئ نموذج firestore-to-firestore مسارًا مجمّعًا بين قواعد بيانات Cloud Firestore.

يُعدّ الاستيراد والتصدير الخيار الأبسط للتشغيل مع خيارات ضبط أقل.

يوفّر نموذج "Dataflow" المزيد من خيارات التخصيص. يمكنك توسيع رمز النموذج لإجراء عمليات نقل جزئية أو تحويل البيانات. يمكنك أيضًا التحكّم في عدد العمال وحجمهم.

يتيح كلا الخيارَين عمليات نقل البيانات على مستوى المشاريع والمناطق.

نقل البيانات باستخدام ميزتَي التصدير والاستيراد

لنقل البيانات باستخدام عمليات التصدير والاستيراد، يُرجى الاطّلاع على تصدير البيانات واستيرادها. لنقل البيانات إلى قاعدة بيانات في مشروع آخر، يُرجى الاطّلاع على مقالة نقل البيانات بين المشاريع.

نقل البيانات باستخدام نموذج Dataflow

اتّبِع التعليمات التالية لنقل البيانات باستخدام نموذج firestore-to-firestore Dataflow.

قبل البدء

  1. قبل بدء نقل البيانات، تأكَّد من تفعيل ميزة الاسترداد في نقطة زمنية (PITR) في قاعدة البيانات المصدر. تستخدم مهمة "Dataflow" ميزة "الاستعادة في نقطة زمنية محدّدة" لقراءة البيانات في طابع زمني محدّد. في حال إيقاف ميزة PITR، ستتعذّر المهمة إذا استغرقت أكثر من ساعة.

  2. يجب تفعيل واجهة برمجة التطبيقات datastore.googleapis.com لاستخدام هذا النموذج.

  3. عيِّن الأدوار المطلوبة الموضّحة في القسم التالي.

الأدوار المطلوبة

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

  1. للحصول على الأذونات اللازمة لإنشاء قاعدة بيانات جديدة والوصول إلى بيانات " Cloud Firestore"، اطلب من المشرف منحك دور "إدارة الهوية وإمكانية الوصول" (IAM) ل مالك Cloud Datastore‏ (roles/datastore.owner) في مشروعك.
  2. لمنح مهمة Dataflow إذن الوصول للقراءة والكتابة إلى قواعد بيانات Cloud Firestore، عليك منح حساب خدمة العامل Dataflow (على سبيل المثال، PROJECT_NUMBER-compute@) دور مستخدم Cloud Datastore (roles/datastore.user) في "إدارة الهوية وإمكانية الوصول" (IAM) في مشروعك.

    لمزيد من المعلومات حول أمان "Dataflow"، يُرجى الاطّلاع على أمان "Dataflow" وأذوناته.

لمزيد من المعلومات حول منح أدوار "إدارة الهوية وإمكانية الوصول"، يُرجى الاطّلاع على مقالة إدارة الوصول إلى المشاريع والمجلدات والمؤسسات.

1. إنشاء قاعدة بيانات جديدة في إصدار Firestore Enterprise

لنقل البيانات من قاعدة بيانات إصدار Standard إلى قاعدة بيانات إصدار Enterprise، يجب أولاً إنشاء قاعدة بيانات الوجهة لإصدار Enterprise. يُرجى الاطّلاع على مقالة إنشاء قاعدة بيانات.

2. تشغيل نموذج Dataflow firestore-to-firestore

اضبط مهمة Dataflow وشغِّلها باستخدام نموذج firestore-to-firestore. تتيح النماذج نقل قاعدة البيانات بأكملها أو مجموعات محدّدة فقط.

القيود

يُرجى مراعاة القيود التالية لنموذج firestore-to-firestore Dataflow:

  • يجب أن تكون قاعدة البيانات المصدر من الإصدار العادي.
  • تقرأ عملية نقل البيانات البيانات في وقت قراءة محدّد. ننصحك بتفعيل الاسترداد في نقطة زمنية معيّنة (PITR) في قاعدة البيانات المصدر. إذا لم يتم تفعيل ميزة "الاستعادة في نقطة زمنية محدّدة"، ستنتهي صلاحية البيانات بعد ساعة واحدة، وقد لا يكون ذلك وقتًا كافيًا لإكمال عملية نقل البيانات. تؤدي ميزة PITR إلى تمديد فترة الاحتفاظ بالبيانات إلى سبعة أيام.
  • لا يتم نقل الفهارس.
  • لا تنقل مهمة "Dataflow" إعدادات قاعدة البيانات، مثل سياسات مدة الصلاحية (TTL) والنسخ الاحتياطية وميزة "الاستعادة في نقطة زمنية محدّدة" (PITR) ومفاتيح التشفير التي يديرها العميل (CMEK).

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

توضّح الأمثلة التالية كيفية تشغيل النموذج باستخدام Google Cloud CLI.

نقل جميع البيانات

لنقل جميع البيانات، استخدِم الأمر التالي:

gcloud dataflow flex-template run "JOB_NAME" \
  --project "PROJECT" \
  --template-file-gcs-location gs://dataflow-templates-REGION_NAME/VERSION/flex/Cloud_Firestore_to_Firestore \
  --region REGION_NAME \
  --parameters "sourceProjectId=SOURCE_PROJECT_ID" \
  --parameters "sourceDatabaseId=SOURCE_DATABASE_ID" \
  --parameters "destinationProjectId=DESTINATION_PROJECT_ID" \
  --parameters "destinationDatabaseId=DESTINATION_DATABASE_ID" \
  --parameters "readTime=READ_TIME"

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

  • ‫JOB_NAME: اسم المهمة
  • ‫PROJECT: معرّف مشروع Google Cloud
  • ‫REGION_NAME: موقع Google Cloud الذي تريد تشغيل مهمة Dataflow فيه استخدِم موقعًا جغرافيًا قريبًا من قواعد بياناتك.
  • ‫VERSION: إصدار النموذج الذي تريد استخدامه يمكنك استخدام القيم التالية:

    • latest لاستخدام أحدث إصدار من النموذج، وهو متاح في المجلد الرئيسي غير المؤرَّخ في الحزمة: gs://dataflow-templates-REGION_NAME/latest/
    • اسم الإصدار، مثل 2023-09-12-00_RC00، لاستخدام إصدار معيّن من النموذج، والذي يمكن العثور عليه متداخلًا في المجلد الرئيسي المؤرَّخ ذي الصلة في الحزمة— gs://dataflow-templates-REGION_NAME/
  • ‫SOURCE_PROJECT_ID: معرّف مشروع Google Cloud المصدر الذي يحتوي على قاعدة بيانات إصدار Firestore Standard

  • ‫SOURCE_DATABASE_ID: معرّف قاعدة بيانات Cloud Firestore المصدر

  • ‫DESTINATION_PROJECT_ID: معرّف مشروع Google Cloud المقصود لقاعدة بيانات Cloud Firestore الجديدة

  • ‫DESTINATION_DATABASE_ID: معرّف قاعدة بيانات الوجهة Cloud Firestore

  • ‫READ_TIME: الطابع الزمني لقراءة البيانات من قاعدة البيانات المصدر يجب ضبطه على طابع زمني بتنسيق RFC 3339، مع تحديد الدقائق، مثل 2026-05-15T16:31:00.00Z.

    يعتمد أقرب طابع زمني صالح على إعدادات الاستعادة في نقطة زمنية معيّنة (PITR). يُرجى الاطّلاع على الحصول على وقت أقدم نسخة.

نقل مجموعات محدّدة

لنقل مجموعات معيّنة فقط، استخدِم الأمر التالي:

gcloud dataflow jobs run "JOB_NAME" \
  --project "PROJECT" \
  --gcs-location gs://dataflow-templates-REGION_NAME/VERSION/Cloud_Firestore_to_Firestore \
  --region REGION_NAME \
  --parameters "sourceProjectId=SOURCE_PROJECT_ID" \
  --parameters "sourceDatabaseId=SOURCE_DATABASE_ID" \
  --parameters "collectionGroupIds=COLLECTION_GROUP_IDS" \
  --parameters "destinationProjectId=DESTINATION_PROJECT_ID" \
  --parameters "destinationDatabaseId=DESTINATION_DATABASE_ID" \
  --parameters "readTime=READ_TIME"

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

  • ‫JOB_NAME: اسم المهمة
  • ‫PROJECT: معرّف مشروع Google Cloud
  • ‫REGION_NAME: موقع Google Cloud الذي تريد تشغيل مهمة Dataflow فيه استخدِم موقعًا جغرافيًا قريبًا من قواعد بياناتك.
  • ‫VERSION: إصدار النموذج الذي تريد استخدامه يمكنك استخدام القيم التالية:

    • latest لاستخدام أحدث إصدار من النموذج، وهو متاح في المجلد الرئيسي غير المؤرَّخ في الحزمة: gs://dataflow-templates-REGION_NAME/latest/
    • اسم الإصدار، مثل 2023-09-12-00_RC00، لاستخدام إصدار معيّن من النموذج، والذي يمكن العثور عليه مدمجًا في المجلد الرئيسي ذي الصلة الذي يحمل تاريخًا في الحزمة— gs://dataflow-templates-REGION_NAME/
  • ‫SOURCE_PROJECT_ID: معرّف مشروع Google Cloud المصدر الذي يحتوي على قاعدة بيانات الإصدار العادي من Firestore

  • ‫SOURCE_DATABASE_ID: معرّف قاعدة بيانات Cloud Firestore المصدر

  • ‫COLLECTION_GROUP_IDS: قائمة قيم مفصولة بفاصلة لأرقام تعريف مجموعات المجموعات المطلوب نقلها.

    لا يتم تضمين المجموعات الفرعية بشكل متكرر. على سبيل المثال، إذا حدّدت مجموعة المجموعات users، لن تتضمّن عملية النقل المجموعة الفرعية messages في /users/userid/messages ما لم تحدّد أيضًا مجموعة المجموعات messages.

  • ‫DESTINATION_PROJECT_ID: معرّف مشروع Google Cloud المقصود لقاعدة بيانات Cloud Firestore الجديدة

  • ‫DESTINATION_DATABASE_ID: معرّف قاعدة بيانات الوجهة Cloud Firestore

  • ‫READ_TIME: الطابع الزمني لقراءة البيانات من قاعدة البيانات المصدر يجب ضبطه على طابع زمني بتنسيق RFC 3339، مع تحديد الدقائق، مثل 2026-05-15T16:31:00.00Z.

    يعتمد أقرب طابع زمني صالح على إعدادات الاستعادة في نقطة زمنية معيّنة (PITR). يُرجى الاطّلاع على الحصول على وقت أقدم نسخة.

3- ضبط قاعدة البيانات

تنقل مهمة firestore-to-firestore البيانات فقط. لا يتم نقل الفهارس وإعدادات قواعد البيانات الأخرى. بالإضافة إلى نقل البيانات، يمكنك ضبط ما يلي في قاعدة البيانات الجديدة:

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

تحديد المشاكل وحلّها

بالنسبة إلى قواعد البيانات الكبيرة، قد تفشل المهمة إذا قرأت الكثير من البيانات في آنٍ واحد. لحلّ هذه المشكلة، عليك تنفيذ ما يلي:

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