Eksportowanie danych z Firebase do BigQuery

Firebase udostępnia w konsoli Firebase narzędzia do przeglądania i analizowania danych historycznych dotyczących aplikacji, które korzystają z usług Firebase. Dzięki tym narzędziom możesz uzyskać odpowiedzi na wiele pytań dotyczących sposobu korzystania z Twoich aplikacji. Czasami jednak chcesz skonfigurować własne zapytania, aby uzyskać odpowiedzi na swoje pytania.

Możesz to zrobić, eksportując dane z różnych usług Firebase do BigQuery. Dzięki BigQuery możesz analizować dane za pomocą BigQuery SQL lub eksportować je, aby używać ich we własnych narzędziach.

Te usługi obsługują eksportowanie danych do BigQuery:

• Google Analytics
• Cloud Messaging
• Crashlytics
• Performance Monitoring
• A/B Testing
• Personalizacja w Remote Config

Wymagane uprawnienia i sugerowane role

Aby wyświetlać ustawienia eksportowania danych do usługi BigQuery i nimi zarządzać, musisz mieć wymagany poziom dostępu.

Jeśli nie masz wymaganego dostępu do Firebase, możesz poprosić właściciela projektu Firebase o przypisanie Ci odpowiedniej roli w ustawieniach uprawnień konsoli Firebase. Jeśli masz pytania dotyczące dostępu do projektu w Firebase, w tym znajdowania lub przypisywania właściciela, zapoznaj się z najczęstszymi pytaniami na temat uprawnień i dostępu do projektów w Firebase.

Na poziomie projektu

Poniższa tabela dotyczy łączenia projektu Firebase z usługą BigQuery na najwyższym poziomie.

Działanie w konsoli Firebase	Wymagane uprawnienia uprawnienia	Role uprawnień, które domyślnie obejmują wymagane uprawnienia	Dodatkowe wymagane role
Połącz projekt w Firebase i BigQuery	firebase.links.create	Właściciel Administrator Firebase	brak
Odłączanie projektu w Firebase i usługi BigQuery	firebase.links.delete	Właściciel Administrator Firebase	brak
Wyświetl istniejące linki dla: BigQuery	firebase.links.list	dowolna rola podstawowa (właściciel, edytujący lub wyświetlający); dowolna rola na poziomie Firebase, dowolna rola w kategorii usług Firebase.	brak

Google Analytics

Poniższa tabela dotyczy eksportu danych Google Analytics do BigQuery.

Działanie w konsoli Firebase	Wymagane uprawnienia uprawnienia	Role uprawnień, które domyślnie obejmują wymagane uprawnienia	Dodatkowe wymagane role
Włączanie eksportowania danych z: Google Analytics do: BigQuery	firebase.links.update ORAZ serviceusage.services.enable ORAZ resourcemanager.projects.getIamPolicy ORAZ resourcemanager.projects.setIamPolicy	Właściciel Administrator Firebase ORAZ Administrator korzystania z usług ORAZ Administrator uprawnień projektu	Google Analytics: odpowiednik roli Administrator lub Edytujący na koncie w przypadku połączonej usługi Google Analytics. Zobacz uwagę poniżej.
Włączanie eksportu w przypadku konkretnych aplikacji w Firebase	firebase.links.update	Właściciel Administrator Firebase	Google Analytics: odpowiednik administratora lub edytującego na koncie w przypadku połączonej usługi Google Analytics. Zobacz uwagę poniżej.
Wyłączanie eksportu w przypadku konkretnych aplikacji w Firebase	firebase.links.update	Właściciel Administrator Firebase	Google Analytics: odpowiednik administratora lub edytującego na koncie w przypadku połączonej usługi Google Analytics. Zobacz uwagę poniżej.

Uwaga: aby włączyć lub wyłączyć eksportowanie w interfejsie Google Analytics, musisz mieć w połączonej usłudze Google Analytics rolę Administrator lub Edytujący. Dostęp do Firebase nie jest jednak wymagany.

Usługi Firebase

Poniższa tabela dotyczy wszystkich usług Firebase, z których możesz eksportować dane do BigQuery, np. Crashlytics lub Performance Monitoring.

Działanie w konsoli Firebase	Wymagane uprawnienia uprawnienia	Role uprawnień, które domyślnie obejmują wymagane uprawnienia	Dodatkowe wymagane role
Włącz eksport danych usługi do BigQuery	firebase.links.update	Właściciel Administrator Firebase	brak
Włączanie eksportu w przypadku konkretnych aplikacji w Firebase	firebase.links.update	Właściciel Administrator Firebase	brak
Wyłączanie eksportu w przypadku konkretnych aplikacji w Firebase	firebase.links.update	Właściciel Administrator Firebase	brak

---

Konfigurowanie eksportu do: BigQuery

1. Zaloguj się w konsoli Firebase i wybierz swój projekt.

2. Otwórz Settings (Ustawienia) > Integrations tab (karta Integracje).

3. Na karcie BigQuery kliknij Połącz.

4. Aby skonfigurować eksportowanie do BigQuery, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

Odłącz od: BigQuery

Odłączenie od BigQuery powoduje zakończenie wypełniania odpowiednich zbiorów danych w BigQuery.

Pamiętaj:

• Wszystkie dane wyeksportowane już do BigQuery będą przechowywane przez dozwolony czas przechowywania i mogą być naliczane opłaty za przechowywanie oraz wykonywanie zapytań. Możesz ręcznie usunąć zbiory danych, aby uniknąć dalszych opłat.

• Jeśli masz dane BigQuery przechowywane w innych usługach, mogą one podlegać innym warunkom przechowywania danych.

Możesz odłączyć BigQuery na poziomie projektu Firebase, na poziomie usługi lub na poziomie aplikacji w przypadku konkretnej usługi.

Uwaga: odłączenie projektu w Firebase od BigQuery spowoduje zatrzymanie całego eksportu danych z dowolnej usługi Firebase (oraz, jeśli dotyczy, Google Analytics), dla której skonfigurowano eksport do BigQuery.

Aby odłączyć konto od BigQuery:

1. W konsoli Firebase otwórz Ustawienia > karta Integracje.

2. Na karcie BigQuery kliknij Zarządzaj.

3. Możesz odłączyć konkretny produkt lub konkretne aplikacje dla konkretnego produktu.

   Aby całkowicie odłączyć projekt w Firebase, znajdź przycisk u dołu strony.

4. Gdy pojawi się komunikat, potwierdź, że chcesz zatrzymać eksportowanie.

---

Co się stanie, gdy włączysz eksportowanie?

• Wybierasz lokalizację zbioru danych. Gdy zostanie on utworzony, jego lokalizacji nie można już zmienić. Możesz natomiast skopiować zbiór danych do innej lokalizacji lub go ręcznie przenieść przez ponowne utworzenie tego zbioru w innej lokalizacji. Więcej informacji znajdziesz w artykule Zmienianie lokalizacji dotychczasowych eksportów.

  Ta lokalizacja dotyczy tylko danych eksportowanych do BigQuery i nie ma wpływu na lokalizację danych przechowywanych do użytku w konsoli Firebase.

• Domyślnie wszystkie aplikacje w projekcie są połączone z BigQuery. Wszystkie aplikacje, które dodasz do projektu później, także zostaną automatycznie połączone z BigQuery. Możesz określić, które aplikacje mają wysyłać dane.

• Firebase eksportuje kopię dotychczasowych danych do: BigQuery. Początkowe rozpowszechnianie danych do eksportu może potrwać do 48 godzin.

• Firebase konfiguruje codzienne synchronizacje danych z BigQuery.

  • Po połączeniu projektu musisz zwykle poczekać do synchronizacji następnego dnia, aby pierwszy zestaw danych został wyeksportowany do BigQuery.

  • Codzienna synchronizacja odbywa się raz dziennie, niezależnie od zaplanowanego eksportu, który możesz skonfigurować w BigQuery. Pamiętaj, że czas i czas trwania zadania synchronizacji mogą się zmieniać, dlatego nie zalecamy planowania operacji ani zadań podrzędnych na podstawie określonego czasu eksportu.

  Uwaga: eksport danych Google Analytics do BigQuery jest ograniczony do 1 miliona zdarzeń dziennie. Aby ograniczyć liczbę eksportowanych zdarzeń, możesz użyć opcji ich filtrowania. Więcej informacji znajdziesz w sekcji Filtrowanie danych. Użytkowników Google Analytics 360 limity nie obowiązują.

---

Zmiana lokalizacji dotychczasowych eksportów

Po skonfigurowaniu usługi do eksportowania do BigQuery i utworzeniu zbioru danych nie możesz zmienić lokalizacji tego zbioru danych. Możesz jednak skopiować istniejący zbiór danych do nowego zbioru danych, który ma inną lokalizację, i zresetować eksport danych do tej nowej lokalizacji. Dowiedz się więcej o lokalizacjach zbiorów danych BigQuery.

Wykonaj wszystkie instrukcje opisane w tych procedurach. Pominięcie któregoś kroku może spowodować utratę danych.

Wybierz usługę, dla której chcesz zmienić lokalizację eksportu danych.

Google Analytics

Aby zmienić lokalizację dotychczasowego eksportu Google Analytics do BigQuery, wykonaj te czynności:

1. W konsoli Firebase otwórz Ustawienia > karta Integracje. Następnie:

   1. Na karcie BigQuery kliknij Zarządzaj.
   2. Aby wyłączyć BigQuery, przesuń suwak Google Analytics.

2. W konsoli Google Cloud otwórz stronę BigQuery. Następnie:

   1. Utwórz tymczasowy zbiór danych, aby przechowywać kopię istniejących danych z oryginalnego zbioru danych. Przypisz tymczasowemu zbiorowi danych inną nazwę niż nazwa oryginalnego zbioru danych.
   2. Skopiuj lub przenieś dane z pierwotnego zbioru danych do tymczasowego zbioru danych.
   3. Usuń pierwotny zbiór danych.
   4. Utwórz nowy, stały zbiór danych o tej samej nazwie co pierwotny zbiór danych (analytics_ANALYTICS_PROPERTY_ID), a następnie wybierz nowy region.
   5. Skopiuj lub przenieś dane z tymczasowego zbioru danych do nowego zbioru danych, a następnie usuń tymczasowy zbiór danych.

3. Wróć do konsoli Firebase i karty BigQuery. Następnie:

   1. Aby ponownie włączyć integrację z BigQuery, ustaw suwak Google Analytics w pozycji włączonej.
   2. Wybierz aplikacje, dla których chcesz włączyć eksportowanie.

Komunikacja w chmurze

Aby zmienić lokalizację dotychczasowego eksportu Cloud Messaging do BigQuery, wykonaj te czynności:

1. W konsoli Firebase otwórz Ustawienia > karta Integracje. Następnie:

   1. Na karcie BigQuery kliknij Zarządzaj.
   2. Aby wyłączyć BigQuery, przesuń suwak Cloud Messaging.

2. W konsoli Google Cloud otwórz stronę BigQuery. Następnie:

   1. Utwórz tymczasowy zbiór danych, aby przechowywać kopię istniejących danych z oryginalnego zbioru danych. Przypisz tymczasowemu zbiorowi danych inną nazwę niż nazwa oryginalnego zbioru danych.
   2. Skopiuj lub przenieś dane z pierwotnego zbioru danych do tymczasowego zbioru danych.
   3. Usuń pierwotny zbiór danych.
   4. Utwórz nowy, stały zbiór danych o tej samej nazwie co oryginalny zbiór danych (firebase_messaging), a następnie wybierz nowy region.
   5. Skopiuj lub przenieś dane z tymczasowego zbioru danych do nowego zbioru danych, a następnie usuń tymczasowy zbiór danych.

3. Wróć do konsoli Firebase i karty BigQuery. Następnie:

   1. Aby ponownie włączyć integrację z BigQuery, ustaw suwak Cloud Messaging w pozycji włączonej.
   2. Wybierz aplikacje, dla których chcesz włączyć eksportowanie.

4. Wróć do konsoli Google Cloud i na stronę BigQuery, aby sprawdzić, czy konfiguracja transferu została utworzona dla Cloud Messaging w nowym regionie.

Crashlytics

Aby zmienić lokalizację dotychczasowego eksportu Crashlytics do BigQuery, wykonaj te czynności:

1. W konsoli Firebase otwórz Ustawienia > karta Integracje. Następnie:

   1. Na karcie BigQuery kliknij Zarządzaj.
   2. Aby wyłączyć BigQuery, przesuń suwak Crashlytics.

2. W konsoli Google Cloud otwórz stronę BigQuery. Następnie:

   1. Utwórz tymczasowy zbiór danych, aby przechowywać kopię istniejących danych z oryginalnego zbioru danych. Przypisz tymczasowemu zbiorowi danych inną nazwę niż nazwa oryginalnego zbioru danych.
   2. Skopiuj lub przenieś dane z pierwotnego zbioru danych do tymczasowego zbioru danych.
   3. Usuń pierwotny zbiór danych.
   4. Utwórz nowy, stały zbiór danych o tej samej nazwie co oryginalny zbiór danych (firebase_crashlytics), a następnie wybierz nowy region.
   5. Skopiuj lub przenieś dane z tymczasowego zbioru danych do nowego zbioru danych, a następnie usuń tymczasowy zbiór danych.

3. Wróć do konsoli Firebase i karty BigQuery. Następnie:

   1. Aby ponownie włączyć integrację z BigQuery, ustaw suwak Crashlytics w pozycji włączonej.
   2. Wybierz aplikacje, dla których chcesz włączyć eksportowanie.

4. Wróć do konsoli Google Cloud i na stronę BigQuery, aby sprawdzić, czy konfiguracja transferu została utworzona dla Crashlytics w nowym regionie.

Monitorowanie wydajności

Aby zmienić lokalizację dotychczasowego eksportu Performance Monitoring do BigQuery, wykonaj te czynności:

1. W konsoli Firebase otwórz Ustawienia > karta Integracje. Następnie:

   1. Na karcie BigQuery kliknij Zarządzaj.
   2. Aby wyłączyć BigQuery, przesuń suwak Performance Monitoring.

2. W konsoli Google Cloud otwórz stronę BigQuery. Następnie:

   1. Utwórz tymczasowy zbiór danych, aby przechowywać kopię istniejących danych z oryginalnego zbioru danych. Przypisz tymczasowemu zbiorowi danych inną nazwę niż nazwa oryginalnego zbioru danych.
   2. Skopiuj lub przenieś dane z pierwotnego zbioru danych do tymczasowego zbioru danych.
   3. Usuń pierwotny zbiór danych.
   4. Utwórz nowy, stały zbiór danych o tej samej nazwie co oryginalny zbiór danych (firebase_performance), a następnie wybierz nowy region.
   5. Skopiuj lub przenieś dane z tymczasowego zbioru danych do nowego zbioru danych, a następnie usuń tymczasowy zbiór danych.

3. Wróć do konsoli Firebase i karty BigQuery. Następnie:

   1. Aby ponownie włączyć integrację z BigQuery, ustaw suwak Performance Monitoring w pozycji włączonej.
   2. Wybierz aplikacje, dla których chcesz włączyć eksportowanie.

4. Wróć do konsoli Google Cloud i na stronę BigQuery, aby sprawdzić, czy konfiguracja transferu została utworzona dla Performance Monitoring w nowym regionie.

---

Ceny i piaskownica BigQuery

Jeśli Twój projekt w Firebase jest objęty bezpłatnym abonamentem Spark, możesz korzystać z piaskownicy BigQuery, która zapewnia bezpłatny dostęp próbny do BigQuery. Informacje o piaskownicy BigQuery i jej możliwościach znajdziesz w artykule Korzystanie z piaskownicy BigQuery.

Jeśli Twój projekt w Firebase jest objęty abonamentem Blaze z płatnością według wykorzystania, możesz korzystać ze wszystkich funkcji BigQuery. Korzystanie z usługi BigQuery podlega cenom BigQuery, które obejmują ograniczone bezpłatne korzystanie.