تصدير بيانات 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. في بطاقة BigQuery، انقر على ربط.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

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

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

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

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

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

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

---

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

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

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

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

إحصاءات 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 الحالي إلى 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

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

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