將項目數據導出到 BigQuery

Firebase 在 Firebase 控制台中提供了工具來探索和分析專案的歷史資料。這些工具可以幫助您回答有關應用程式使用方式的許多問題。但有時，您也想設定自己的查詢來回答自己的問題。

您可以透過將專案資料從 Firebase 匯出到BigQuery來實現此目的。借助 BigQuery，您可以使用 BigQuery SQL 分析資料或匯出資料以與您自己的工具一起使用。

您可以將 Firebase 配置為將資料從以下 Firebase 產品匯出到 BigQuery：

• 分析
• 雲端訊息傳遞
• 崩潰解決方案
• 效能監控
• A/B 測試
• 遠端配置個人化

所需的權限和建議的角色

要查看或管理將資料匯出到 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分析

下表專門適用於將 Google Analytics 資料匯出至 BigQuery。

Firebase 控制台中的操作	所需的 IAM 權限	預設包含所需權限的 IAM 角色	其他所需角色
允許將 Google Analytics 資料匯出到 BigQuery	firebase.links.update 和 serviceusage.services.enable	擁有者 Firebase 管理員 和 服務使用管理	Google Analytics ：相當於連結的 Google Analytics 資源的帳戶管理員或編輯者 請參閱下面的註釋。
為特定 Firebase 應用程式啟用導出	firebase.links.update	擁有者 Firebase 管理員	Google Analytics ：相當於連結的 Google Analytics 資源的帳戶管理員或編輯者 請參閱下面的註釋。
停用特定 Firebase 應用程式的匯出	firebase.links.update	擁有者 Firebase 管理員	Google Analytics ：相當於連結的 Google Analytics 資源的帳戶管理員或編輯者 請參閱下面的註釋。

注意：要在 Google Analytics UI 中啟用或停用匯出，您需要連結的 Google Analytics 屬性的明確管理員或編輯者角色。但是，不需要 Firebase 存取權限。

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。

注意：每天將 Google Analytics 資料匯出到 BigQuery 的事件數限制為100 萬個。您可以使用事件篩選來限制匯出的事件數量。要了解更多信息，請參閱數據過濾。 Google Analytics 360用戶沒有限制。

當您為 Google Analytics、效能監控或雲端訊息啟用 BigQuery 匯出時：

• 您選擇資料集區域。建立資料集後，位置無法更改，但您可以將資料集複製到其他位置或手動移動（重新建立）到其他位置的資料集。要了解更多信息，請參閱更改資料集位置。

  注意：資料集區域選擇僅適用於 Google Analytics、效能監控和雲端訊息傳遞。 Crashlytics 僅支援將資料匯出到美國。

• 預設情況下，專案中的所有應用程式都會連結到 BigQuery，並且您以後新增到專案中的任何應用程式都會自動連結到 BigQuery。您可以管理哪些應用程式發送資料。 Google Analytics 中的Google Analytics 4媒體資源中的所有網路資料也會自動匯出。

• Firebase 將現有資料的副本匯出到 BigQuery。

• Firebase 設定每日將資料從 Firebase 專案同步到 BigQuery。

若要停用 BigQuery 匯出，請在 Firebase 控制台中取消連結您的專案。

變更資料集位置

為產品啟用 BigQuery 匯出並建立資料集後，您將無法變更該資料集的位置。但是，您可以將現有資料集複製到具有不同位置的新資料集。

注意：資料集區域選擇僅適用於 Google Analytics、效能監控和雲端訊息傳遞。 Crashlytics 僅支援將資料匯出到美國。

若要了解 BigQuery 資料集位置，請參閱資料集位置。

選擇您想要變更資料集位置的產品。

注意：請確保遵循這些過程中的所有說明；忽略一個步驟可能會導致資料遺失。

Google Analytics效能監控雲端訊息傳遞

若要變更雲端訊息資料集的位置，請按照以下說明操作：

1. 前往 Firebase 控制台中的整合頁面。
2. 在 BigQuery 卡中，點選「管理」 。
3. 關閉雲端訊息傳遞滑桿以停用 BigQuery。
4. 前往 Google Cloud Console 中的BigQuery頁面。
5. 建立臨時資料集來儲存原始資料集中現有資料的副本。為臨時資料集指定一個與原始資料集名稱不同的名稱。
6. 將資料從原始資料集複製或移動到臨時資料集。
7. 刪除原始資料集。
8. 建立一個與原始資料集同名的新的永久資料集 ( firebase_messaging )，然後選擇所需的區域。
9. 將資料從臨時資料集複製或移動到新資料集，然後刪除臨時資料集。
10. 對於新資料集，按一下共用標籤並選擇權限。然後新增[e-mail]委託人作為 BigQuery 資料擁有者。
11. 前往 Firebase 控制台並開啟 Cloud Messaging 滑桿以重新啟用 BigQuery。然後選擇您想要啟用匯出的應用程式。
12. 前往 Google Cloud Console 中的BigQuery頁面，並驗證是否已在新區域中為 Cloud Messaging 建立傳輸配置。

定價和 BigQuery 沙盒

如果您的 Firebase 專案採用免費 Spark 計劃，您可以將 Crashlytics、Cloud Messaging、Google Analytics 和效能監控連結到BigQuery 沙盒，從而提供對 BigQuery 的免費存取。有關BigQuery 沙箱功能的信息，請參閱使用BigQuery 沙箱。

如果您的 Firebase 專案採用付費計劃，您可以將 A/B 測試、Crashlytics、Cloud Messaging、Google Analytics 和效能監控連結到 BigQuery。您對 BigQuery 的使用須遵守BigQuery 的正常定價，其中包括有限的免費使用。