プロジェクト データを BigQuery にエクスポートする

Firebase では、プロジェクトの履歴データを調べたり分析したりするためのツールが Firebase コンソールに用意されています。これらのツールで、アプリの利用状況のさまざまな疑問に対する回答を得られます。とはいえ、自分独自の疑問に対する回答を得るために独自のクエリを作成したい場合もあります。

独自のクエリを作成するには、プロジェクト データを Firebase から BigQuery にエクスポートします。BigQuery を使用すると、BigQuery SQL でデータを分析したり、データをエクスポートして独自のツールで使用したりできます。

Firebase を構成して、次の Firebase プロダクトから BigQuery にデータをエクスポートできます。

• Analytics
• Cloud Messaging
• Crashlytics
• Performance Monitoring
• A/B Testing
• Remote Config のパーソナライズ

必要な権限と推奨されるロール

BigQuery へのデータ エクスポートの設定を表示または管理するには、それに対応するレベルのアクセス権が必要です。

必要な Firebase アクセス権がない場合は、Firebase プロジェクトのオーナーに、Firebase コンソールの IAM 設定を介して該当するロールを割り当ててもらうよう依頼してください。オーナーの確認や割り当てなど、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 管理者 かつ Service Usage 管理者 かつ プロジェクト IAM 管理者	Google Analytics: リンクされた Google Analytics プロパティのアカウント管理者または編集者と同等 下記の注を参照。
特定の Firebase アプリのエクスポートを有効にする	firebase.links.update	オーナー Firebase 管理者	Google アナリティクス: リンクされた Google Analytics プロパティのアカウント管理者または編集者と同等 下記の注を参照。
特定の Firebase アプリのエクスポートを無効にする	firebase.links.update	オーナー Firebase 管理者	Google アナリティクス: リンクされた Google Analytics プロパティのアカウント管理者または編集者と同等 下記の注を参照。

Firebase プロダクト

次の表は、Crashlytics や Performance Monitoring など、BigQuery にデータをエクスポートできる Firebase プロダクトに適用されます。

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 でスケジュール設定したエクスポートに関係なく、1 日 1 回行われます。同期ジョブのタイミングと所要時間は変更される可能性があるため、エクスポートの特定のタイミングに基づいてダウンストリーム オペレーションやジョブをスケジュールすることはおすすめしません。

BigQuery へのエクスポートを無効にするには、Firebase コンソールでプロジェクトのリンクを解除します。

既存のエクスポートのロケーションを変更する

プロダクトで BigQuery エクスポートを有効にしてデータセットを作成した後は、そのデータセットのロケーションを変更できません。ただし、既存のデータセットを別のロケーションの新しいデータセットにコピーし、その新しいロケーションにデータ エクスポートをリセットすることはできます。BigQuery データセットのロケーションについて学習する。

データ エクスポートのロケーションを変更するプロダクトを選択する

既存の Crashlytics エクスポートのロケーションを BigQuery に変更する手順は次のとおりです。

1. Firebase コンソールで、[統合] ページに移動します。 次に、以下の操作を行います。

   1. [BigQuery] カードで [管理] をクリックします。
   2. Crashlytics のスライダーをオフに切り替えて、BigQuery を無効にします。

2. Google Cloud コンソールで、[BigQuery] ページに移動します。 次に、以下の操作を行います。

   1. 元のデータセット内の既存データをコピーして保存するための、一時的なデータセットを作成します。一時的なデータセットに、元のデータセットとは異なる名前を割り当てます。
   2. 元のデータセットから一時的なデータセットにデータをコピーまたは移動します。
   3. 元のデータセットを削除します。
   4. 元のデータセット（firebase_crashlytics）と同じ名前の新しい永続的なデータセットを作成し、目的のリージョンを選択します。
   5. 一時的なデータセットから新しいデータセットにデータをコピーまたは移動してから、一時的なデータセットを削除します。

3. Firebase コンソールと BigQuery カードに戻ります。 次に、以下の操作を行います。

   1. Crashlytics のスライダーをオンに切り替えて、BigQuery 統合を再度有効にします。
   2. 次に、エクスポートを有効にするアプリを選択します。

4. Google Cloud コンソールに戻り、[BigQuery] ページで、新しいリージョンの Crashlytics に転送構成が作成されていることを確認します。

料金と BigQuery サンドボックス

Firebase プロジェクトを料金のかからない Spark プランで利用している場合は、Crashlytics、Cloud Messaging、Google Analytics、Performance Monitoring を BigQuery サンドボックスにリンクできます。これにより、コストをかけずに BigQuery にアクセスできます。BigQuery サンドボックスの機能については、BigQuery サンドボックスの使用をご覧ください。

Firebase プロジェクトを有料プランで使用している場合は、A/B Testing、Crashlytics、Cloud Messaging、Google Analytics、Performance Monitoring を BigQuery にリンクできます。BigQuery の使用には通常の BigQuery の料金が適用されますが、これには上限のある無料の使用も含まれます。