داده های پروژه را به BigQuery صادر کنید

Firebase ابزارهایی را در کنسول Firebase برای کاوش و تجزیه و تحلیل داده های تاریخی پروژه شما فراهم می کند. این ابزارها می توانند به شما کمک کنند به بسیاری از سوالات در مورد نحوه استفاده از برنامه هایتان پاسخ دهید. با این حال، گاهی اوقات شما همچنین می خواهید سوالات خود را برای پاسخ به سوالات خود تنظیم کنید.

می توانید این کار را با صادرات داده های پروژه خود از Firebase به BigQuery انجام دهید. با BigQuery ، می توانید داده های خود را با BigQuery SQL تجزیه و تحلیل کنید یا داده ها را برای استفاده با ابزارهای خود صادر کنید.

می‌توانید Firebase را برای صادرات داده‌ها به BigQuery از محصولات Firebase زیر پیکربندی کنید:

• 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 Admin	هیچ کدام
پیوند پروژه Firebase و BigQuery را لغو کنید	firebase.links.delete	مالک Firebase Admin	هیچ کدام
پیوندهای موجود برای 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 Admin و مدیریت استفاده از خدمات و پروژه IAM Admin	Google Analytics : معادل Administrator یا Editor حساب برای ویژگی Google Analytics مرتبط یادداشت زیر را ببینید .
صادرات را برای برنامه های خاص Firebase فعال کنید	firebase.links.update	مالک Firebase Admin	Google Analytics : معادل Administrator یا Editor حساب برای ویژگی Google Analytics مرتبط یادداشت زیر را ببینید .
صادرات را برای برنامه های خاص Firebase غیرفعال کنید	firebase.links.update	مالک Firebase Admin	Google Analytics : معادل Administrator یا Editor حساب برای ویژگی Google Analytics مرتبط یادداشت زیر را ببینید .

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

محصولات Firebase

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

اکشن در کنسول Firebase	مجوز IAM مورد نیاز است	نقش(های) IAM که به طور پیش فرض شامل مجوزهای مورد نیاز است	نقش های اضافی مورد نیاز
صادرات داده های محصول به BigQuery را فعال کنید	firebase.links.update	مالک Firebase Admin	هیچ کدام
صادرات را برای برنامه های خاص Firebase فعال کنید	firebase.links.update	مالک Firebase Admin	هیچ کدام
صادرات را برای برنامه های خاص Firebase غیرفعال کنید	firebase.links.update	مالک Firebase Admin	هیچ کدام

صادرات به BigQuery را فعال کنید

1. در کنسول Firebase ، به صفحه ادغام بروید.

2. در کارت BigQuery ، روی پیوند کلیک کنید.

3. دستورالعمل های روی صفحه را دنبال کنید تا صادرات به BigQuery را فعال کنید.

وقتی صادرات را فعال می کنید چه اتفاقی می افتد؟

• شما مکان مجموعه داده را انتخاب می کنید. پس از ایجاد مجموعه داده، مکان را نمی توان تغییر داد، اما می توانید مجموعه داده را در مکان دیگری کپی کنید یا به صورت دستی مجموعه داده را در مکان دیگری منتقل کنید (بازآفرینی کنید). برای کسب اطلاعات بیشتر، به تغییر مکان برای صادرات موجود مراجعه کنید.

  این مکان فقط برای داده های صادر شده به BigQuery قابل اجرا است و بر مکان داده های ذخیره شده برای استفاده در کنسول Firebase تأثیری ندارد.

  توجه: قابلیت انتخاب و تغییر مکان برای صادرات داده به طور پیش‌فرض برای Google Analytics ، Performance Monitoring و Cloud Messaging در دسترس است. برای Crashlytics ، فقط در صورت فعال کردن صادرات پس از اواسط اکتبر 2024 یا ارتقا به زیرساخت صادرات جدید ، می‌توانید مکان را برای صادرات انتخاب و تغییر دهید.

• به‌طور پیش‌فرض، همه برنامه‌های پروژه شما به BigQuery مرتبط می‌شوند و هر برنامه‌ای که بعداً به پروژه اضافه می‌کنید به‌طور خودکار به BigQuery مرتبط می‌شود. می‌توانید مدیریت کنید که کدام برنامه‌ها داده‌ها را ارسال می‌کنند .

• Firebase یک کپی از داده های موجود شما را به BigQuery صادر می کند. انتشار اولیه داده ها برای صادرات ممکن است تا 48 ساعت طول بکشد.

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

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

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

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

برای غیرفعال کردن صادرات به BigQuery ، پیوند پروژه خود را در کنسول Firebase لغو کنید.

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

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

توجه: قابلیت تغییر مکان برای صادرات داده به طور پیش‌فرض برای Google Analytics ، Performance Monitoring و Cloud Messaging موجود است. برای Crashlytics ، فقط در صورت فعال کردن صادرات پس از اواسط اکتبر 2024 یا ارتقا به زیرساخت صادرات جدید ، می‌توانید مکان را برای صادرات انتخاب و تغییر دهید.

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

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

مانیتورینگ عملکرد Google Analytics Crashlytics پیام‌رسانی ابری

برای تغییر مکان صادرات 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. برای فعال کردن مجدد ادغام BigQuery ، نوار لغزنده Google Analytics را تغییر دهید.
   2. برنامه هایی را که می خواهید صادرات را برای آنها فعال کنید انتخاب کنید.

قیمت گذاری و جعبه شنی BigQuery

اگر پروژه Firebase شما در طرح Spark بدون هزینه است، می‌توانید Crashlytics ، Cloud Messaging ، Google Analytics ، و Performance Monitoring به جعبه ایمنی BigQuery پیوند دهید، که دسترسی بدون هزینه به BigQuery را فراهم می‌کند. برای اطلاعات در مورد قابلیت های جعبه ایمنی BigQuery به استفاده از BigQuery ایمنی BigQuery مراجعه کنید.

اگر پروژه Firebase شما دارای یک طرح پولی است، می‌توانید A/B Testing ، Crashlytics ، Cloud Messaging ، Google Analytics و Performance Monitoring را به BigQuery پیوند دهید. استفاده شما از BigQuery منوط به قیمت گذاری معمولی BigQuery است که شامل استفاده محدود و بدون هزینه می شود.