لنقل البيانات من قاعدة بيانات Firestore Standard إلى قاعدة بيانات Firestore Enterprise، ننصحك باستخدام أحد الخيارات التالية:
ميزتا الاستيراد والتصدير تتوافق ملفات البيانات من عملية الاستيراد مع كل من إصدار Enterprise والإصدار Standard.
نموذج Dataflow
firestore-to-firestoreتتيح لك خدمة Dataflow إنشاء مسارات بيانات، وينشئ نموذجfirestore-to-firestoreمسارًا مجمّعًا بين قواعد بيانات Cloud Firestore.
يُعدّ الاستيراد والتصدير الخيار الأبسط للتشغيل مع خيارات ضبط أقل.
يوفّر نموذج "Dataflow" المزيد من خيارات التخصيص. يمكنك توسيع رمز النموذج لإجراء عمليات نقل جزئية أو تحويل البيانات. يمكنك أيضًا التحكّم في عدد العمال وحجمهم.
يتيح كلا الخيارَين عمليات نقل البيانات على مستوى المشاريع والمناطق.
نقل البيانات باستخدام ميزتَي التصدير والاستيراد
لنقل البيانات باستخدام عمليات التصدير والاستيراد، يُرجى الاطّلاع على تصدير البيانات واستيرادها. لنقل البيانات إلى قاعدة بيانات في مشروع آخر، يُرجى الاطّلاع على مقالة نقل البيانات بين المشاريع.
نقل البيانات باستخدام نموذج Dataflow
اتّبِع التعليمات التالية لنقل البيانات باستخدام نموذج
firestore-to-firestore Dataflow.
قبل البدء
قبل بدء نقل البيانات، تأكَّد من تفعيل ميزة الاسترداد في نقطة زمنية (PITR) في قاعدة البيانات المصدر. تستخدم مهمة "Dataflow" ميزة "الاستعادة في نقطة زمنية محدّدة" لقراءة البيانات في طابع زمني محدّد. في حال إيقاف ميزة PITR، ستتعذّر المهمة إذا استغرقت أكثر من ساعة.
يجب تفعيل واجهة برمجة التطبيقات
datastore.googleapis.comلاستخدام هذا النموذج.عيِّن الأدوار المطلوبة الموضّحة في القسم التالي.
الأدوار المطلوبة
لنقل البيانات من قاعدة بيانات إلى أخرى، يجب إسناد الأدوار التالية. قد تتمكّن أيضًا من الحصول على الأذونات المطلوبة من خلال الأدوار المخصّصة أو الأدوار الأخرى المحدّدة مسبقًا:
- للحصول على الأذونات اللازمة لإنشاء قاعدة بيانات جديدة والوصول إلى بيانات "
Cloud Firestore"، اطلب من المشرف منحك دور "إدارة الهوية وإمكانية الوصول" (IAM) ل
مالك Cloud Datastore
(
roles/datastore.owner) في مشروعك. -
لمنح مهمة 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 البيانات فقط.
لا يتم نقل الفهارس وإعدادات قواعد البيانات الأخرى. بالإضافة إلى نقل البيانات، يمكنك ضبط ما يلي في قاعدة البيانات الجديدة:
الفهارس: لا تتطلّب قواعد بيانات إصدار Firestore Enterprise فهارس بشكل صارم لتشغيل طلبات البحث، ولا تنشئ فهارس تلقائية بشكل تلقائي. راجِع ما يلي لإنشاء فهارس لطلبات البحث:
- نظرة عامة على فهرس إصدار Firestore Enterprise
- تحسين أداء طلبات البحث باستخدام الفهارس
- يمكنك استخدام واجهة سطر الأوامر (CLI) في Firebase من أجل تصدير الفهارس ونشرها في قاعدة البيانات الجديدة.
- استخدِم إحصاءات طلبات البحث لتحديد طلبات البحث التي يمكنك تحسينها باستخدام فهرس.
TTL: إنشاء سياسات TTL
النُسخ الاحتياطية: إعداد النُسخ الاحتياطية
PITR: تفعيل ميزة PITR
بعد ضبط قاعدة البيانات، يمكنك مواصلة اختبار تطبيقك باستخدام قاعدة البيانات الجديدة. لإكمال عملية النقل، عليك تحديث تطبيقاتك لاستخدام قاعدة البيانات الجديدة.
تحديد المشاكل وحلّها
بالنسبة إلى قواعد البيانات الكبيرة، قد تفشل المهمة إذا قرأت الكثير من البيانات في آنٍ واحد. لحلّ هذه المشكلة، عليك تنفيذ ما يلي:
زيادة قيمة
maxNumWorkers
الخطوات التالية
- مزيد من المعلومات عن تنفيذ طلبات بحث في البيانات باستخدام عمليات Pipeline
- مساعد الدراسة حول كيفية تحسين طلبات البحث في إصدار Firestore Enterprise
- التعرّف على كيفية توسيع نطاق قاعدة بيانات إصدار Enterprise