صادر کردن داده‌های 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 بخواهید نقش مربوطه را ازطریق تنظیمات IAM کنسول Firebase به شما اختصاص دهد. اگر درباره دسترسی به پروژه Firebase خود سؤالی دارید، ازجمله پیدا کردن یا اختصاص دادن «مالک»، پرسشگان اجازه‌ها و دسترسی به پروژه‌های Firebase را مرور کنید.

سطح پروژه

جدول زیر برای پیوند دادن سطح بالای پروژه Firebase به BigQuery اعمال می‌شود.

کنش در کنسول Firebase	اجازه IAM لازم	نقش(های) IAM که به‌طور پیش‌فرض شامل اجازه‌های لازم است	نقش‌های الزامی دیگر
پیوند دادن پروژه Firebase و BigQuery	firebase.links.create	مالک سرپرست Firebase	هیچ‌کدام
لغو پیوند پروژه Firebase و BigQuery	firebase.links.delete	مالک سرپرست Firebase	هیچ‌کدام
مشاهده پیوندهای موجود برای BigQuery	firebase.links.list	هر نقش پایه‌ای (مالک، ویرایشگر، یا بیننده) هر نقش سطح Firebase هر نقش دسته محصول Firebase	هیچ‌کدام

Google Analytics

جدول زیر به‌طور خاص برای صادر کردن داده‌های Google Analytics به BigQuery اعمال می‌شود.

کنش در کنسول Firebase	اجازه IAM لازم	نقش(های) IAM که به‌طور پیش‌فرض شامل اجازه‌های لازم است	نقش‌های الزامی دیگر
فعال کردن صادر کردن داده‌های Google Analytics به BigQuery	firebase.links.update و serviceusage.services.enable و resourcemanager.projects.getIamPolicy و resourcemanager.projects.setIamPolicy	مالک سرپرست Firebase و سرپرست استفاده از سرویس و سرپرست IAM پروژه	Google Analytics: معادل «سرپرست» یا «ویرایشگر» حساب برای دارایی Google Analytics پیوندشده یادداشت زیر را ببینید.
فعال کردن صادر کردن برای برنامه‌های Firebase خاص	firebase.links.update	مالک سرپرست Firebase	Google Analytics: معادل «سرپرست» یا «ویرایشگر» حساب برای دارایی Google Analytics پیوندشده یادداشت زیر را ببینید.
غیرفعال کردن صادر کردن برای برنامه‌های Firebase خاص	firebase.links.update	مالک سرپرست Firebase	Google Analytics: معادل «سرپرست» یا «ویرایشگر» حساب برای دارایی Google Analytics پیوندشده یادداشت زیر را ببینید.

توجه: برای فعال یا غیرفعال کردن صادر کردن در واسط کاربر Google Analytics، به نقش صریح سرپرست یا ویرایشگر برای دارایی Google Analytics پیوندشده نیاز دارید. اما دسترسی به Firebase الزامی نیست.

محصولات Firebase

جدول زیر برای هریک از محصولات Firebase که می‌توانید داده‌های آن را به BigQuery صادر کنید، مثلاً Crashlytics یا Performance Monitoring، اعمال می‌شود.

کنش در کنسول Firebase	اجازه IAM لازم	نقش(های) IAM که به‌طور پیش‌فرض شامل اجازه‌های لازم است	نقش‌های الزامی دیگر
فعال کردن برون‌برد داده‌های محصول به 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 پیوند داده می‌شود. می‌توانید مدیریت کنید کدام برنامه‌ها داده ارسال کنند.

• Firebase نسخه‌ای از داده‌های موجود شما را به BigQuery صادر می‌کند. انتشار اولیه داده‌ها برای صادر کردن ممکن است تا ۴۸ ساعت طول بکشد.

• Firebase همگام‌سازی روزانه داده‌هایتان را در BigQuery راه‌اندازی می‌کند.

  • پس‌از پیوند دادن پروژه‌تان، معمولاً باید تا همگام‌سازی روز بعد صبر کنید تا اولین مجموعه داده‌هایتان به BigQuery صادر شود.

  • همگام‌سازی روزانه یک‌بار در روز انجام می‌شود، صرف‌نظر از هرگونه صادر کردن زمان‌بندی‌شده‌ای که ممکن است در BigQuery راه‌اندازی کرده باشید. توجه داشته باشید که زمان‌بندی و مدت کار همگام‌سازی می‌تواند تغییر کند، بنابراین توصیه نمی‌کنیم عملیات یا کارهای پایین‌دستی را براساس زمان‌بندی خاصی از صادر کردن زمان‌بندی کنید.

  توجه: صادر کردن داده‌های Google Analytics به BigQuery به ۱ میلیون رویداد در روز محدود است. می‌توانید از فیلتر کردن رویداد برای محدود کردن تعداد رویدادهای صادرشده استفاده کنید. برای کسب اطلاعات بیشتر، فیلتر کردن داده‌ها را ببینید. برای کاربران Google Analytics 360 محدودیتی وجود ندارد.

---

تغییر مکان برای برون‌بردهای موجود

پس‌از راه‌اندازی محصولی برای صادر کردن به BigQuery و ایجاد مجموعه داده، نمی‌توانید مکان آن مجموعه داده را تغییر دهید. اما می‌توانید مجموعه داده‌های موجودتان را در مجموعه داده‌های جدیدی که مکان متفاوتی دارد کپی کنید و صادر کردن داده‌هایتان را به آن مکان جدید بازنشانی کنید. با مکان‌های مجموعه داده BigQuery آشنا شوید.

مطمئن شوید که همه دستورالعمل‌های این رویه‌ها را دنبال می‌کنید؛ نادیده گرفتن یک مرحله ممکن است منجر به ازدست رفتن داده‌ها شود.

محصولی را که می‌خواهید مکان صادر کردن داده‌های آن را تغییر دهید انتخاب کنید

Google Analytics

برای تغییر مکان صادر کردن Google Analytics موجود به BigQuery، این دستورالعمل‌ها را دنبال کنید:

1. در کنسول Firebase، به تنظیمات > زبانه «ادغام‌ها» بروید. سپس موارد زیر را انجام دهید:

   1. در کارت BigQuery، روی مدیریت کلیک کنید.
   2. برای غیرفعال کردن BigQuery، لغزنده Google Analytics را خاموش کنید.

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. برای غیرفعال کردن BigQuery، لغزنده Cloud Messaging را خاموش کنید.

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. برای غیرفعال کردن BigQuery، لغزنده Crashlytics را خاموش کنید.

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. برای غیرفعال کردن BigQuery، لغزنده Performance Monitoring را خاموش کنید.

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 sandbox استفاده کنید که دسترسی آزمایشی بدون هزینه به BigQuery را فراهم می‌کند. برای کسب اطلاعات درباره BigQuery sandbox و قابلیت‌های آن، به استفاده از BigQuery sandbox مراجعه کنید.

اگر پروژه Firebase شما در طرح قیمت‌گذاری Blaze پرداخت به اندازه استفاده باشد، می‌توانید از همه ویژگی‌های BigQuery استفاده کنید. استفاده شما از BigQuery تابع قیمت‌گذاری BigQuery است، که شامل استفاده محدود بدون هزینه می‌شود.