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 프로젝트 소유자에게 Firebase 콘솔 IAM 설정을 통해 관련 역할을 할당해 달라고 요청할 수 있습니다. 소유자 찾기 또는 할당 등 Firebase 프로젝트에 액세스하는 방법에 관해 궁금한 점이 있으면 Firebase 프로젝트의 권한 및 액세스 FAQ를 참조하세요.

프로젝트 수준

다음 표는 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 애널리틱스: 연결된 Google Analytics 속성에 대한 계정 관리자 또는 편집자와 동등한 역할 아래의 참고를 확인하세요.
특정 Firebase 앱에 내보내기 사용 중지	firebase.links.update	소유자 Firebase 관리자	Google 애널리틱스: 연결된 Google Analytics 속성에 대한 계정 관리자 또는 편집자와 동등한 역할 아래의 참고를 확인하세요.

Firebase 제품

다음 표는 BigQuery로 데이터를 내보낼 수 있는 모든 Firebase 제품(예: 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. BigQuery 카드에서 연결을 클릭합니다.

3. 화면에 표시된 안내에 따라 BigQuery로 내보내기를 사용 설정합니다.

내보내기를 사용 설정하면 어떻게 되나요?

• 데이터 세트 위치를 선택합니다. 데이터 세트를 만든 후에는 위치를 변경할 수 없지만 데이터 세트를 다른 위치에 복사하거나 다른 위치에서 데이터 세트를 수동으로 이동(다시 만들기)할 수 있습니다. 자세한 내용은 기존 내보내기 위치 변경을 참조하세요.

  이 위치는 BigQuery로 내보낸 데이터에만 적용되며 Firebase 콘솔에서 사용하기 위해 저장된 데이터의 위치에는 영향을 미치지 않습니다.

• 기본적으로 프로젝트에 있는 모든 앱은 BigQuery에 연결되며 나중에 프로젝트에 추가한 앱은 BigQuery에 자동으로 연결됩니다. 데이터를 전송하는 앱을 별도로 관리할 수 있습니다.

• Firebase에서 기존 데이터의 사본을 BigQuery로 내보냅니다. 내보내기용 데이터 초기 전파를 완료하는 데 최대 48시간이 걸릴 수 있습니다.

• Firebase에서 BigQuery로의 일일 데이터 동기화를 설정합니다.

  • 프로젝트를 연결한 후 첫 번째 데이터 세트를 BigQuery로 내보내려면 일반적으로 다음 날 동기화가 완료될 때까지 기다려야 합니다.

  • 일일 동기화는 BigQuery에서 설정했을 수 있는 예약된 내보내기에 관계없이 하루에 한 번 실행됩니다. 동기화 작업의 타이밍과 기간을 변경할 수 있으므로 내보내기의 특정 시점을 기준으로 다운스트림 작업을 예약하지 않는 것이 좋습니다.

BigQuery로의 내보내기를 중지하려면 Firebase 콘솔에서 프로젝트를 연결 해제합니다.

기존 내보내기 위치 변경

제품을 BigQuery 내보내기용으로 사용 설정하고 데이터 세트를 만든 후에 데이터 세트 위치를 변경할 수 없습니다. 그러나 기존 데이터 세트를 다른 위치의 새 데이터 세트에 복사하고 데이터 내보내기를 새 위치로 재설정할 수 있습니다. BigQuery 데이터 세트 위치를 알아보세요.

데이터 내보내기 위치를 변경할 제품을 선택합니다.

기존 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. 내보내기를 사용 설정할 앱을 선택합니다.

가격 책정 및 BigQuery 샌드박스

Firebase 프로젝트에서 무료 Spark 요금제를 사용하고 있으면 BigQuery에 무료로 액세스할 수 있는 BigQuery 샌드박스에 Crashlytics, Cloud Messaging, Google Analytics, Performance Monitoring을 연결할 수 있습니다. BigQuery 샌드박스의 기능에 대한 자세한 내용은 BigQuery 샌드박스 사용을 참조하세요.

Firebase 프로젝트에서 유료 요금제를 사용하고 있으면 BigQuery에 A/B Testing, Crashlytics, Cloud Messaging, Google Analytics, Performance Monitoring을 연결할 수 있습니다. BigQuery를 사용하면 무료 사용을 제한하는 일반 BigQuery 가격 책정이 적용됩니다.