プロジェクト データを 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 AND serviceusage.services.enable	オーナー Firebase 管理者 かつ Service Usage 管理者	Google Analytics: リンクされた Google Analytics プロパティのアカウント管理者または編集者と同等 下記の注を参照。
特定の Firebase アプリのエクスポートを有効にする	firebase.links.update	オーナー Firebase 管理者	Google アナリティクス: リンクされた Google Analytics プロパティのアカウント管理者または編集者と同等 下記の注を参照。
特定の Firebase アプリのエクスポートを無効にする	firebase.links.update	オーナー Firebase 管理者	Google アナリティクス: リンクされた Google Analytics プロパティのアカウント管理者または編集者と同等 下記の注を参照。

注: Google Analytics 管理画面でエクスポートを有効または無効にするには、リンクされた Google Analytics プロパティに関する明示的な管理者または編集者のロールが必要です。ただし、Firebase のアクセス権は必要ありません。

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 へのエクスポートを有効にすると、次のようになります。

• データセットのロケーションを選択します。データセットの作成後はロケーションを変更できませんが、データセットを別のロケーションにコピーするか、データセットを別のロケーションに手動で移動（再作成）することはできます。詳細については、データセットのロケーションの変更をご覧ください。

  注: データセットのロケーションを選択する機能は、Google Analytics、Performance Monitoring、Cloud Messaging で使用できます。
  Crashlytics では、データのエクスポート先は米国のみがサポートされています。

• デフォルトでは、プロジェクト内のすべてのアプリが BigQuery にリンクされ、後からプロジェクトに追加するアプリもすべて BigQuery に自動的にリンクされます。データを送信するアプリを管理することもできます。

• Firebase は BigQuery に既存データのコピーをエクスポートします。

• Firebase は、Firebase プロジェクトから BigQuery へのデータの毎日の同期を設定します。

  注: Google Analytics データの BigQuery へのエクスポートは、1 日あたり 100 万 イベントに制限されています。イベントのフィルタリングを使用すると、エクスポートするイベントの数を制限できます。詳細については、データのフィルタリングをご覧ください。Google アナリティクス 360 のユーザーである場合は、制限はありません。

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

データセットのロケーションを変更する

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

注: データセットのロケーションを選択して変更する機能は、Google Analytics、Performance Monitoring、Cloud Messaging でのみ使用できます。
Crashlytics では、データのエクスポート先は米国のみがサポートされています。

注意: 必ず、以下の手順をすべて行ってください。手順の見落としがあるとデータが失われる可能性があります。

データセットのロケーションを変更するプロダクトを選択してください。

Google アナリティクス Performance Monitoring Cloud Messaging

Google Analytics　データセットのロケーションを変更する手順は次のとおりです。

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 プランで利用している場合は、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 の料金が適用されますが、料金がかからない制限付きの使用枠も含まれています。