تصدير بيانات Firebase إلى BigQuery

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

يمكنك إجراء ذلك من خلال تصدير البيانات من منتجات Firebase المختلفة إلى BigQuery. باستخدام BigQuery، يمكنك تحليل بياناتك باستخدام BigQuery SQL أو تصدير البيانات لاستخدامها مع أدواتك الخاصة.

تتيح المنتجات التالية تصدير البيانات إلى BigQuery:

• Google Analytics
• Cloud Messaging
• Crashlytics
• Performance Monitoring
• A/B Testing
• Remote Config التخصيص

الأذونات المطلوبة والأدوار المقترَحة

لعرض إعدادات تصدير البيانات إلى BigQuery أو إدارتها، يجب أن يكون لديك مستوى الوصول المطلوب.

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

على مستوى المشروع

ينطبق الجدول التالي على عملية الربط على أعلى مستوى بين مشروع Firebase وBigQuery.

الإجراء في وحدة تحكّم Firebase	إذن "إدارة الهوية وإمكانية الوصول" المطلوب	أدوار "إدارة الهوية وإمكانية الوصول" التي تتضمّن الأذونات المطلوبة تلقائيًا	الأدوار الإضافية المطلوبة
ربط مشروع على Firebase وBigQuery	firebase.links.create	المالك مشرف Firebase	لا شيء
إلغاء ربط مشروع Firebase وBigQuery	firebase.links.delete	المالك مشرف Firebase	لا شيء
عرض الروابط الحالية الخاصة بـ BigQuery	firebase.links.list	أي دور أساسي (المالك أو المحرّر أو المُشاهد) أي دور على مستوى Firebase أي دور في فئة منتجات Firebase	لا شيء

Google Analytics

ينطبق الجدول التالي تحديدًا على تصدير بيانات Google Analytics إلى BigQuery.

الإجراء في وحدة تحكّم Firebase	إذن "إدارة الهوية وإمكانية الوصول" المطلوب	أدوار "إدارة الهوية وإمكانية الوصول" التي تتضمّن الأذونات المطلوبة تلقائيًا	الأدوار الإضافية المطلوبة
تفعيل تصدير بيانات Google Analytics إلى BigQuery	firebase.links.update و serviceusage.services.enable و resourcemanager.projects.getIamPolicy و resourcemanager.projects.setIamPolicy	المالك مشرف Firebase و مشرف استخدام الخدمة و مشرف إدارة الهوية وإمكانية الوصول في المشروع	Google Analytics: مكافئ لمشرف الحساب أو محرّره في الموقع Google Analytics المرتبط يُرجى الاطّلاع على الملاحظة أدناه.
تفعيل التصدير لتطبيقات Firebase محدّدة	firebase.links.update	المالك مشرف Firebase	إحصاءات Google: مكافئ لمشرف الحساب أو المحرّر في الموقع المرتبط Google Analytics يُرجى الاطّلاع على الملاحظة أدناه.
إيقاف التصدير لتطبيقات Firebase معيّنة	firebase.links.update	المالك مشرف Firebase	إحصاءات Google: مكافئ لمشرف الحساب أو المحرّر في الموقع المرتبط Google Analytics يُرجى الاطّلاع على الملاحظة أدناه.

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

منتجات Firebase

ينطبق الجدول التالي على أي من منتجات Firebase التي يمكنك تصدير البيانات منها إلى BigQuery، مثل Crashlytics أو Performance Monitoring.

الإجراء في وحدة تحكّم Firebase	إذن "إدارة الهوية وإمكانية الوصول" المطلوب	أدوار "إدارة الهوية وإمكانية الوصول" التي تتضمّن الأذونات المطلوبة تلقائيًا	الأدوار الإضافية المطلوبة
تفعيل تصدير بيانات المنتج إلى BigQuery	firebase.links.update	المالك مشرف Firebase	لا شيء
تفعيل التصدير لتطبيقات Firebase محدّدة	firebase.links.update	المالك مشرف Firebase	لا شيء
إيقاف التصدير لتطبيقات Firebase معيّنة	firebase.links.update	المالك مشرف Firebase	لا شيء

---

إعداد عملية التصدير إلى BigQuery

1. سجِّل الدخول إلى وحدة تحكّم Firebase، ثم اختَر مشروعك.

2. انقر على ، ثم اختَر إعدادات المشروع.

3. اختَر علامة التبويب عمليات الدمج.

4. في بطاقة دمج BigQuery، انقر على ربط.

5. اتّبِع التعليمات الظاهرة على الشاشة لإعداد عملية التصدير إلى BigQuery.

إلغاء الربط بـ "BigQuery"

يؤدي إلغاء الربط من BigQuery إلى إيقاف تعبئة مجموعات البيانات المقابلة في BigQuery.

يُرجى الانتباه إلى ما يلي:

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

• إذا كانت لديك بيانات BigQuery مخزَّنة في خدمات أخرى، قد تخضع هذه البيانات لبنود مختلفة بشأن استمرار توفّر البيانات.

يمكنك إلغاء الربط من BigQuery على مستوى مشروع Firebase أو على مستوى المنتج أو على مستوى التطبيق لمنتج معيّن.

تنبيه: يؤدي إلغاء ربط مشروعك على Firebase بـ BigQuery إلى إيقاف جميع عمليات تصدير البيانات من أي منتج من منتجات Firebase (وGoogle Analytics إذا كان ذلك منطبقًا) التي أعددت لها عملية التصدير إلى BigQuery.

في ما يلي كيفية إلغاء الربط من BigQuery:

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

2. في بطاقة BigQuery، انقر على إدارة.

3. اختَر إلغاء ربط منتج معيّن أو إلغاء ربط تطبيقات معيّنة بمنتج معيّن.

   لإلغاء ربط مشروعك في Firebase بالكامل، ابحث عن الزر في أسفل الصفحة.

4. عندما يُطلب منك ذلك، أكِّد رغبتك في إيقاف عمليات التصدير.

---

ماذا يحدث عند تفعيل ميزة التصدير؟

• اختَر موقع مجموعة البيانات. بعد إنشاء مجموعة البيانات، لا يمكن تغيير الموقع الجغرافي، ولكن يمكنك نسخ مجموعة البيانات إلى موقع جغرافي آخر أو نقلها (إعادة إنشائها) يدويًا في موقع جغرافي آخر. لمزيد من المعلومات، اطّلِع على تغيير الموقع الجغرافي لعمليات التصدير الحالية.

  لا ينطبق هذا الموقع الجغرافي إلا على البيانات التي يتم تصديرها إلى BigQuery، ولا يؤثّر في موقع البيانات المخزَّنة لاستخدامها في وحدة تحكّم Firebase.

  ملاحظة: تتوفّر إمكانية اختيار الموقع الجغرافي لتصدير البيانات وتغييره تلقائيًا في Google Analytics وCloud Messaging وPerformance Monitoring. بالنسبة إلى Crashlytics، يمكنك اختيار الموقع الجغرافي وتغييره للتصدير فقط إذا فعّلت ميزة التصدير بعد منتصف أكتوبر 2024 أو إذا رقّيت إلى البنية الأساسية الجديدة للتصدير.

• يتم تلقائيًا ربط جميع التطبيقات الموجودة ضمن مشروعك بأداة BigQuery، وبالنسبة إلى أية تطبيقات تتم إضافتها إلى المشروع لاحقًا، يتم أيضًا ربطها تلقائيًا بأداة BigQuery. يمكنك إدارة عمليات اختيار التطبيقات التي ترسل البيانات.

• تصدِّر Firebase نسخة من بياناتك الحالية إلى BigQuery. قد يستغرق نشر البيانات الأوّلي للتصدير مدة تصل إلى 48 ساعة.

• يُعدّ Firebase عمليات مزامنة يومية لبياناتك مع BigQuery.

  • بعد ربط مشروعك، عليك عادةً الانتظار حتى تتم المزامنة في اليوم التالي ليتم تصدير المجموعة الأولى من البيانات إلى BigQuery.

  • تتم المزامنة اليومية مرة واحدة في اليوم، بغض النظر عن أي عملية تصدير مجدولة ربما تكون قد أعددتها في BigQuery. يُرجى العِلم أنّ توقيت مهمة المزامنة ومدتها قد يتغيّران، لذا لا ننصح بجدولة العمليات أو المهام اللاحقة استنادًا إلى توقيت محدّد للتصدير.

  ملاحظة: تقتصر عمليات تصدير بيانات Google Analytics إلى BigQuery على مليون حدث في اليوم. ويمكنك استخدام ميزة فلترة الأحداث للحدّ من عدد الأحداث التي يتم تصديرها. لمزيد من المعلومات، يُرجى الاطّلاع على فلترة البيانات. ما مِن حدود مفروضة لمستخدمي إحصاءات Google‏ 360.

---

تغيير الموقع الجغرافي لعمليات التصدير الحالية

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

ملاحظة: تتوفّر إمكانية تغيير الموقع الجغرافي لتصدير البيانات تلقائيًا في Google Analytics وCloud Messaging وPerformance Monitoring. بالنسبة إلى Crashlytics، يمكنك اختيار الموقع الجغرافي وتغييره للتصدير فقط إذا فعّلت ميزة التصدير بعد منتصف أكتوبر 2024 أو إذا رقّيت إلى البنية الأساسية الجديدة للتصدير.

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

اختيار المنتج الذي تريد تغيير الموقع الجغرافي لتصدير البيانات منه

إحصاءات Google

لتغيير موقع عملية تصدير Google Analytics حالية إلى BigQuery، اتّبِع التعليمات التالية:

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات الدمج. بعد ذلك، يُرجى اتّباع ما يلي:

   1. في بطاقة BigQuery، انقر على إدارة.
   2. انقر على شريط التمرير Google Analytics لإيقاف BigQuery.

2. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة BigQuery. بعد ذلك، يُرجى اتّباع ما يلي:

   1. أنشئ مجموعة بيانات مؤقتة لتخزين نسخة من البيانات الحالية من مجموعة البيانات الأصلية. امنح مجموعة البيانات المؤقتة اسمًا مختلفًا عن اسم مجموعة البيانات الأصلية.
   2. انسخ أو انقل البيانات من مجموعة البيانات الأصلية إلى مجموعة البيانات المؤقتة.
   3. احذف مجموعة البيانات الأصلية.
   4. أنشِئ مجموعة بيانات جديدة ودائمة بالاسم نفسه لمجموعة البيانات الأصلية (analytics_ANALYTICS_PROPERTY_ID)، ثم اختَر المنطقة الجديدة.
   5. انسخ البيانات أو انقلها من مجموعة البيانات المؤقتة إلى مجموعة البيانات الجديدة، ثم احذف مجموعة البيانات المؤقتة.

3. ارجع إلى Firebase وحدة التحكّم وبطاقة BigQuery. بعد ذلك، يُرجى اتّباع ما يلي:

   1. فعِّل شريط التمرير Google Analytics لإعادة تفعيل عملية الدمج مع BigQuery.
   2. اختَر التطبيقات التي تريد تفعيل ميزة التصدير لها.

خدمة المراسلة عبر السحابة الإلكترونية

لتغيير موقع عملية تصدير Cloud Messaging حالية إلى BigQuery، اتّبِع التعليمات التالية:

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات الدمج. بعد ذلك، يُرجى اتّباع ما يلي:

   1. في بطاقة BigQuery، انقر على إدارة.
   2. انقر على شريط التمرير Cloud Messaging لإيقاف BigQuery.

2. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة BigQuery. بعد ذلك، يُرجى اتّباع ما يلي:

   1. أنشئ مجموعة بيانات مؤقتة لتخزين نسخة من البيانات الحالية من مجموعة البيانات الأصلية. امنح مجموعة البيانات المؤقتة اسمًا مختلفًا عن اسم مجموعة البيانات الأصلية.
   2. انسخ أو انقل البيانات من مجموعة البيانات الأصلية إلى مجموعة البيانات المؤقتة.
   3. احذف مجموعة البيانات الأصلية.
   4. أنشِئ مجموعة بيانات جديدة ودائمة بالاسم نفسه لمجموعة البيانات الأصلية (firebase_messaging)، ثم اختَر المنطقة الجديدة.
   5. انسخ البيانات أو انقلها من مجموعة البيانات المؤقتة إلى مجموعة البيانات الجديدة، ثم احذف مجموعة البيانات المؤقتة.

3. ارجع إلى Firebase وحدة التحكّم وبطاقة BigQuery. بعد ذلك، يُرجى اتّباع ما يلي:

   1. فعِّل شريط التمرير Cloud Messaging لإعادة تفعيل عملية الدمج مع BigQuery.
   2. اختَر التطبيقات التي تريد تفعيل ميزة التصدير لها.

4. ارجع إلى وحدة تحكّم Google Cloud وصفحة BigQuery للتأكّد من إنشاء إعدادات نقل لـ Cloud Messaging في المنطقة الجديدة.

Crashlytics

ملاحظة مهمة: لا تتوفّر إمكانية اختيار الموقع الجغرافي وتغييره لتصدير بيانات Crashlytics إلا إذا فعّلت التصدير بعد منتصف أكتوبر 2024 أو إذا تمت الترقية إلى البنية الأساسية الجديدة للتصدير.

لتغيير موقع عملية تصدير Crashlytics حالية إلى BigQuery، اتّبِع التعليمات التالية:

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات الدمج. بعد ذلك، يُرجى اتّباع ما يلي:

   1. في بطاقة BigQuery، انقر على إدارة.
   2. انقر على شريط التمرير Crashlytics لإيقاف BigQuery.

2. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة BigQuery. بعد ذلك، يُرجى اتّباع ما يلي:

   1. أنشئ مجموعة بيانات مؤقتة لتخزين نسخة من البيانات الحالية من مجموعة البيانات الأصلية. امنح مجموعة البيانات المؤقتة اسمًا مختلفًا عن اسم مجموعة البيانات الأصلية.
   2. انسخ أو انقل البيانات من مجموعة البيانات الأصلية إلى مجموعة البيانات المؤقتة.
   3. احذف مجموعة البيانات الأصلية.
   4. أنشِئ مجموعة بيانات جديدة ودائمة بالاسم نفسه لمجموعة البيانات الأصلية (firebase_crashlytics)، ثم اختَر المنطقة الجديدة.
   5. انسخ البيانات أو انقلها من مجموعة البيانات المؤقتة إلى مجموعة البيانات الجديدة، ثم احذف مجموعة البيانات المؤقتة.

3. ارجع إلى Firebase وحدة التحكّم وبطاقة BigQuery. بعد ذلك، يُرجى اتّباع ما يلي:

   1. فعِّل شريط التمرير Crashlytics لإعادة تفعيل عملية الدمج مع BigQuery.
   2. اختَر التطبيقات التي تريد تفعيل ميزة التصدير لها.

4. ارجع إلى وحدة تحكّم Google Cloud وصفحة BigQuery للتأكّد من إنشاء إعدادات نقل لـ Crashlytics في المنطقة الجديدة.

مراقبة الأداء

لتغيير موقع عملية تصدير Performance Monitoring حالية إلى BigQuery، اتّبِع التعليمات التالية:

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة عمليات الدمج. بعد ذلك، يُرجى اتّباع ما يلي:

   1. في بطاقة BigQuery، انقر على إدارة.
   2. انقر على شريط التمرير Performance Monitoring لإيقاف BigQuery.

2. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة BigQuery. بعد ذلك، يُرجى اتّباع ما يلي:

   1. أنشئ مجموعة بيانات مؤقتة لتخزين نسخة من البيانات الحالية من مجموعة البيانات الأصلية. امنح مجموعة البيانات المؤقتة اسمًا مختلفًا عن اسم مجموعة البيانات الأصلية.
   2. انسخ أو انقل البيانات من مجموعة البيانات الأصلية إلى مجموعة البيانات المؤقتة.
   3. احذف مجموعة البيانات الأصلية.
   4. أنشِئ مجموعة بيانات جديدة ودائمة بالاسم نفسه لمجموعة البيانات الأصلية (firebase_performance)، ثم اختَر المنطقة الجديدة.
   5. انسخ البيانات أو انقلها من مجموعة البيانات المؤقتة إلى مجموعة البيانات الجديدة، ثم احذف مجموعة البيانات المؤقتة.

3. ارجع إلى Firebase وحدة التحكّم وبطاقة BigQuery. بعد ذلك، يُرجى اتّباع ما يلي:

   1. فعِّل شريط التمرير Performance Monitoring لإعادة تفعيل عملية الدمج مع BigQuery.
   2. اختَر التطبيقات التي تريد تفعيل ميزة التصدير لها.

4. ارجع إلى وحدة تحكّم Google Cloud وصفحة BigQuery للتأكّد من إنشاء إعداد نقل لـ Performance Monitoring في المنطقة الجديدة.

---

الأسعار وBigQuery sandbox

إذا كان مشروعك على Firebase ضمن خطة التسعير Spark بدون تكلفة، يمكنك استخدام BigQuery sandbox، الذي يوفّر إمكانية الوصول إلى BigQuery بدون تكلفة. للحصول على معلومات حول BigQuery ووضع الحماية وإمكاناتهما، يُرجى الاطّلاع على استخدام BigQuery في وضع الحماية.

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