Firebase-Daten in BigQuery exportieren

Firebase bietet Tools in der Firebase-Konsole, mit denen Sie Verlaufsdaten zu Ihren Apps, die Firebase-Produkte verwenden, analysieren können. Mit diesen Tools können Sie viele Fragen zur Nutzung Ihrer Apps beantworten. Manchmal möchten Sie aber auch eigene Abfragen einrichten, um Ihre eigenen Fragen zu beantworten.

Dazu können Sie Daten aus verschiedenen Firebase-Produkten nach BigQuery exportieren. Mit BigQuery können Sie Ihre Daten mit BigQuery-SQL analysieren oder die Daten exportieren, um sie mit Ihren eigenen Tools zu verwenden.

Die folgenden Produkte unterstützen den Datenexport nach BigQuery:

• Google Analytics
• Cloud Messaging
• Crashlytics
• Performance Monitoring
• A/B Testing
• Remote Config-Personalisierung

Erforderliche Berechtigungen und empfohlene Rollen

Wenn Sie Einstellungen für den Datenexport nach BigQuery aufrufen oder verwalten möchten, benötigen Sie die erforderliche Zugriffsebene.

Wenn Sie nicht den erforderlichen Firebase-Zugriff haben, können Sie einen Firebase-Projektinhaber bitten, Ihnen die entsprechende Rolle über die IAM-Einstellungen der Firebase Console zuzuweisen. Wenn Sie Fragen zum Zugriff auf Ihr Firebase-Projekt haben, einschließlich der Suche nach einem Inhaber oder der Zuweisung eines Inhabers, lesen Sie die FAQs zu Berechtigungen und Zugriff auf Firebase-Projekte.

auf Projektebene

Die folgende Tabelle gilt für die Verknüpfung eines Firebase-Projekts mit BigQuery auf oberster Ebene.

Aktion in der Firebase Console	Erforderliche IAM-Berechtigung	IAM-Rollen, die standardmäßig die erforderlichen Berechtigungen enthalten	Zusätzliche erforderliche Rollen
Firebase-Projekt und BigQuery verknüpfen	firebase.links.create	Inhaber Firebase-Administrator	Keine
Verknüpfung eines Firebase-Projekts und von BigQuery aufheben	firebase.links.delete	Inhaber Firebase-Administrator	Keine
Vorhandene Links für BigQuery ansehen	firebase.links.list	Eine beliebige einfache Rolle (Inhaber, Bearbeiter oder Betrachter) Eine beliebige Rolle auf Firebase-Ebene Eine beliebige Rolle der Firebase-Produktkategorie	Keine

Google Analytics

Die folgende Tabelle gilt speziell für den Export von Google Analytics-Daten nach BigQuery.

Aktion in der Firebase Console	Erforderliche IAM-Berechtigung	IAM-Rollen, die standardmäßig die erforderlichen Berechtigungen enthalten	Zusätzliche erforderliche Rollen
Export von Google Analytics-Daten nach BigQuery aktivieren	firebase.links.update UND serviceusage.services.enable UND resourcemanager.projects.getIamPolicy UND resourcemanager.projects.setIamPolicy	Inhaber Firebase-Administrator UND Service Usage-Administrator UND Projekt-IAM-Administrator	Google Analytics: Entspricht dem Administrator oder Bearbeiter des Kontos für die verknüpfte Google Analytics-Property Siehe Hinweis unten.
Export für bestimmte Firebase-Apps aktivieren	firebase.links.update	Inhaber Firebase-Administrator	Google Analytics: Entspricht dem Kontoadministrator oder Bearbeiter für die verknüpfte Google Analytics-Property Siehe Hinweis unten.
Export für bestimmte Firebase-Apps deaktivieren	firebase.links.update	Inhaber Firebase-Administrator	Google Analytics: Entspricht dem Kontoadministrator oder Bearbeiter für die verknüpfte Google Analytics-Property Siehe Hinweis unten.

Hinweis: Wenn Sie den Export in der Google Analytics-Benutzeroberfläche aktivieren oder deaktivieren möchten, benötigen Sie die Rolle „Administrator“ oder „Bearbeiter“ für die verknüpfte Google Analytics-Property. Der Zugriff auf Firebase ist jedoch nicht erforderlich.

Firebase-Produkte

Die folgende Tabelle gilt für alle Firebase-Produkte, für die Sie Daten nach BigQuery exportieren können, z. B. Crashlytics oder Performance Monitoring.

Aktion in der Firebase Console	Erforderliche IAM-Berechtigung	IAM-Rollen, die standardmäßig die erforderlichen Berechtigungen enthalten	Zusätzliche erforderliche Rollen
Export der Daten eines Produkts nach BigQuery aktivieren	firebase.links.update	Inhaber Firebase-Administrator	Keine
Export für bestimmte Firebase-Apps aktivieren	firebase.links.update	Inhaber Firebase-Administrator	Keine
Export für bestimmte Firebase-Apps deaktivieren	firebase.links.update	Inhaber Firebase-Administrator	Keine

---

Export nach BigQuery einrichten

1. Melden Sie sich in der Firebase-Konsole an und wählen Sie Ihr Projekt aus.

2. Rufen Sie den Tab Einstellungen > Integrationen auf.

3. Klicken Sie auf der Karte BigQuery auf Verknüpfen.

4. Folgen Sie der Anleitung auf dem Bildschirm, um den Export nach BigQuery einzurichten.

Verknüpfung mit BigQuery aufheben

Wenn Sie die Verknüpfung mit BigQuery aufheben, werden die entsprechenden Datasets in BigQuery nicht mehr gefüllt.

Beachten Sie Folgendes:

• Alle Daten, die bereits nach BigQuery exportiert wurden, bleiben für die zulässige Aufbewahrungsdauer erhalten. Es können weiterhin Speicher- und Abfragegebühren anfallen. Sie können Ihre Datasets manuell löschen, um weitere Abrechnungen zu verhindern.

• Wenn Sie BigQuery-Daten in anderen Diensten gespeichert haben, unterliegen diese Daten möglicherweise anderen Bedingungen hinsichtlich der Datenpersistenz.

Sie können die Verknüpfung mit BigQuery auf der Firebase-Projektebene, auf der Produktebene oder auf der App-Ebene für ein bestimmtes Produkt aufheben.

Achtung: Wenn Sie die Verknüpfung Ihres Firebase-Projekts mit BigQuery aufheben, wird der gesamte Datenexport aus allen Firebase-Produkten (und gegebenenfalls Google Analytics) gestoppt, für die Sie den Export nach BigQuery eingerichtet haben.

So heben Sie die Verknüpfung mit BigQuery auf:

1. Rufen Sie in der Firebase-Konsole den Tab Einstellungen > Integrationen auf.

2. Klicken Sie auf der Karte BigQuery auf Verwalten.

3. Sie können die Verknüpfung eines bestimmten Produkts oder bestimmter Apps für ein bestimmtes Produkt aufheben.

   Wenn Sie die Verknüpfung mit Ihrem Firebase-Projekt vollständig aufheben möchten, klicken Sie auf die Schaltfläche unten auf der Seite.

4. Bestätigen Sie, dass Sie den Export beenden möchten, wenn Sie dazu aufgefordert werden.

---

Was passiert, wenn Sie den Export aktivieren?

• Sie wählen den Speicherort des Datasets aus. Nachdem das Dataset erstellt wurde, kann der Standort nicht mehr geändert werden. Sie können aber das Dataset an einen anderen Standort kopieren oder es manuell verschieben, d. h. an einem anderen Standort neu erstellen. Weitere Informationen finden Sie unter Speicherort für vorhandene Exporte ändern.

  Dieser Standort gilt nur für die nach BigQuery exportierten Daten und hat keine Auswirkungen auf den Standort der Daten, die für die Verwendung in der Firebase-Konsole gespeichert sind.

• Standardmäßig sind alle Apps in Ihrem Projekt mit BigQuery verknüpft. Alle Apps, die Sie später dem Projekt hinzufügen, werden automatisch mit BigQuery verknüpft. Sie können festlegen, welche Apps Daten senden.

• Firebase exportiert eine Kopie Ihrer vorhandenen Daten nach BigQuery. Die erste Übertragung von Daten für den Export kann bis zu 48 Stunden dauern.

• Firebase richtet tägliche Synchronisierungen Ihrer Daten mit BigQuery ein.

  • Nachdem Sie Ihr Projekt verknüpft haben, müssen Sie in der Regel bis zur Synchronisierung am nächsten Tag warten, bis der erste Datensatz nach BigQuery exportiert wird.

  • Die tägliche Synchronisierung erfolgt einmal pro Tag, unabhängig von geplanten Exporten, die Sie möglicherweise in BigQuery eingerichtet haben. Beachten Sie, dass sich der Zeitpunkt und die Dauer des Synchronisierungsjobs ändern können. Wir empfehlen daher nicht, nachgelagerte Vorgänge oder Jobs basierend auf einem bestimmten Zeitpunkt des Exports zu planen.

  Hinweis: Pro Tag dürfen nicht mehr als 1 Million Ereignisse aus Google Analytics nach BigQuery exportiert werden. Mit der Funktion zum Filtern von Ereignissen können Sie die Anzahl der exportierten Ereignisse beschränken. Hier finden Sie weitere Informationen zum Filtern von Daten. Für Google Analytics 360-Nutzer gelten keine Beschränkungen.

---

Speicherort für vorhandene Exporte ändern

Nachdem Sie ein Produkt für den Export nach BigQuery eingerichtet und ein Dataset erstellt haben, können Sie den Standort dieses Datasets nicht mehr ändern. Sie können jedoch Ihr vorhandenes Dataset in ein neues Dataset mit einem anderen Speicherort kopieren und den Datenexport auf diesen neuen Speicherort zurücksetzen. BigQuery-Dataset-Standorte

Achten Sie darauf, dass Sie alle Anweisungen in diesen Verfahren befolgen. Wenn Sie einen Schritt übersehen, kann dies zu Datenverlust führen.

Wählen Sie das Produkt aus, für das Sie den Speicherort für den Datenexport ändern möchten.

Google Analytics

So ändern Sie den Speicherort eines vorhandenen Google Analytics-Exports in BigQuery:

1. Rufen Sie in der Firebase-Konsole den Tab Einstellungen > Integrationen auf. Führen Sie anschließend folgende Schritte aus:

   1. Klicken Sie auf der Karte BigQuery auf Verwalten.
   2. Deaktivieren Sie den Schieberegler Google Analytics, um BigQuery zu deaktivieren.

2. Rufen Sie in der Google Cloud Console die Seite BigQuery auf. Führen Sie anschließend folgende Schritte aus:

   1. Erstellen Sie ein temporäres Dataset, um eine Kopie der vorhandenen Daten aus Ihrem ursprünglichen Dataset zu speichern. Weisen Sie dem temporären Dataset einen anderen Namen als den Namen des ursprünglichen Datasets zu.
   2. Kopieren oder verschieben Sie die Daten aus dem ursprünglichen Dataset in das temporäre Dataset.
   3. Löschen Sie das ursprüngliche Dataset.
   4. Erstellen Sie ein neues, permanentes Dataset mit dem gleichen Namen wie das ursprüngliche Dataset (analytics_ANALYTICS_PROPERTY_ID) und wählen Sie dann die neue Region aus.
   5. Kopieren oder verschieben Sie die Daten aus dem temporären Dataset in das neue Dataset und löschen Sie dann das temporäre Dataset.

3. Kehren Sie zur Firebase-Konsole und zur Karte BigQuery zurück. Führen Sie anschließend folgende Schritte aus:

   1. Aktivieren Sie den Schieberegler Google Analytics, um die BigQuery-Integration wieder zu aktivieren.
   2. Wählen Sie die Apps aus, für die Sie den Export aktivieren möchten.

Cloud Messaging

So ändern Sie den Speicherort eines vorhandenen Cloud Messaging-Exports in BigQuery:

1. Rufen Sie in der Firebase-Konsole den Tab Einstellungen > Integrationen auf. Führen Sie anschließend folgende Schritte aus:

   1. Klicken Sie auf der Karte BigQuery auf Verwalten.
   2. Deaktivieren Sie den Schieberegler Cloud Messaging, um BigQuery zu deaktivieren.

2. Rufen Sie in der Google Cloud Console die Seite BigQuery auf. Führen Sie anschließend folgende Schritte aus:

   1. Erstellen Sie ein temporäres Dataset, um eine Kopie der vorhandenen Daten aus Ihrem ursprünglichen Dataset zu speichern. Weisen Sie dem temporären Dataset einen anderen Namen als den Namen des ursprünglichen Datasets zu.
   2. Kopieren oder verschieben Sie die Daten aus dem ursprünglichen Dataset in das temporäre Dataset.
   3. Löschen Sie das ursprüngliche Dataset.
   4. Erstellen Sie ein neues, dauerhaftes Dataset mit dem gleichen Namen wie das ursprüngliche Dataset (firebase_messaging) und wählen Sie dann die neue Region aus.
   5. Kopieren oder verschieben Sie die Daten aus dem temporären Dataset in das neue Dataset und löschen Sie dann das temporäre Dataset.

3. Kehren Sie zur Firebase-Konsole und zur Karte BigQuery zurück. Führen Sie anschließend folgende Schritte aus:

   1. Aktivieren Sie den Schieberegler Cloud Messaging, um die BigQuery-Integration wieder zu aktivieren.
   2. Wählen Sie die Apps aus, für die Sie den Export aktivieren möchten.

4. Kehren Sie zur Google Cloud-Konsole und zur Seite BigQuery zurück, um zu prüfen, ob eine Übertragungskonfiguration für Cloud Messaging in der neuen Region erstellt wurde.

Crashlytics

So ändern Sie den Speicherort eines vorhandenen Crashlytics-Exports in BigQuery:

1. Rufen Sie in der Firebase-Konsole den Tab Einstellungen > Integrationen auf. Führen Sie anschließend folgende Schritte aus:

   1. Klicken Sie auf der Karte BigQuery auf Verwalten.
   2. Deaktivieren Sie den Schieberegler Crashlytics, um BigQuery zu deaktivieren.

2. Rufen Sie in der Google Cloud Console die Seite BigQuery auf. Führen Sie anschließend folgende Schritte aus:

   1. Erstellen Sie ein temporäres Dataset, um eine Kopie der vorhandenen Daten aus Ihrem ursprünglichen Dataset zu speichern. Weisen Sie dem temporären Dataset einen anderen Namen als den Namen des ursprünglichen Datasets zu.
   2. Kopieren oder verschieben Sie die Daten aus dem ursprünglichen Dataset in das temporäre Dataset.
   3. Löschen Sie das ursprüngliche Dataset.
   4. Erstellen Sie ein neues, dauerhaftes Dataset mit dem gleichen Namen wie das ursprüngliche Dataset (firebase_crashlytics) und wählen Sie dann die neue Region aus.
   5. Kopieren oder verschieben Sie die Daten aus dem temporären Dataset in das neue Dataset und löschen Sie dann das temporäre Dataset.

3. Kehren Sie zur Firebase-Konsole und zur Karte BigQuery zurück. Führen Sie anschließend folgende Schritte aus:

   1. Aktivieren Sie den Schieberegler Crashlytics, um die BigQuery-Integration wieder zu aktivieren.
   2. Wählen Sie die Apps aus, für die Sie den Export aktivieren möchten.

4. Kehren Sie zur Google Cloud-Konsole und zur Seite BigQuery zurück, um zu prüfen, ob eine Übertragungskonfiguration für Crashlytics in der neuen Region erstellt wurde.

Performance Monitoring

So ändern Sie den Speicherort eines vorhandenen Performance Monitoring-Exports in BigQuery:

1. Rufen Sie in der Firebase-Konsole den Tab Einstellungen > Integrationen auf. Führen Sie anschließend folgende Schritte aus:

   1. Klicken Sie auf der Karte BigQuery auf Verwalten.
   2. Deaktivieren Sie den Schieberegler Performance Monitoring, um BigQuery zu deaktivieren.

2. Rufen Sie in der Google Cloud Console die Seite BigQuery auf. Führen Sie anschließend folgende Schritte aus:

   1. Erstellen Sie ein temporäres Dataset, um eine Kopie der vorhandenen Daten aus Ihrem ursprünglichen Dataset zu speichern. Weisen Sie dem temporären Dataset einen anderen Namen als den Namen des ursprünglichen Datasets zu.
   2. Kopieren oder verschieben Sie die Daten aus dem ursprünglichen Dataset in das temporäre Dataset.
   3. Löschen Sie das ursprüngliche Dataset.
   4. Erstellen Sie ein neues, dauerhaftes Dataset mit dem gleichen Namen wie das ursprüngliche Dataset (firebase_performance) und wählen Sie dann die neue Region aus.
   5. Kopieren oder verschieben Sie die Daten aus dem temporären Dataset in das neue Dataset und löschen Sie dann das temporäre Dataset.

3. Kehren Sie zur Firebase-Konsole und zur Karte BigQuery zurück. Führen Sie anschließend folgende Schritte aus:

   1. Aktivieren Sie den Schieberegler Performance Monitoring, um die BigQuery-Integration wieder zu aktivieren.
   2. Wählen Sie die Apps aus, für die Sie den Export aktivieren möchten.

4. Kehren Sie zur Google Cloud-Konsole und zur Seite BigQuery zurück, um zu prüfen, ob eine Übertragungskonfiguration für Performance Monitoring in der neuen Region erstellt wurde.

---

Preise und die BigQuery-Sandbox

Wenn Ihr Firebase-Projekt den kostenlosen Spark-Tarif nutzt, können Sie die BigQuery-Sandbox verwenden, die kostenlosen Testzugriff auf BigQuery bietet. Informationen zur BigQuery-Sandbox und ihren Funktionen finden Sie unter BigQuery-Sandbox verwenden.

Wenn für Ihr Firebase-Projekt das Blaze-Preismodell (Pay as you go) gilt, können Sie alle Funktionen von BigQuery nutzen. Ihre Nutzung von BigQuery unterliegt den BigQuery-Preisen, die eine eingeschränkte kostenlose Nutzung umfassen.