將 Firebase 資料匯出至 BigQuery

Firebase 在Firebase控制台中提供工具，可供您探索及分析使用 Firebase 產品的應用程式歷史資料。這些工具可協助您解答許多關於應用程式使用情況的問題。不過，有時您也想自行設定查詢，以回答自己的問題。

如要這麼做，請將各種 Firebase 產品的資料匯出至 BigQuery。透過 BigQuery，您可以使用 BigQuery SQL 分析資料，也可以匯出資料，以便搭配自有工具使用。

下列產品支援將資料匯出至 BigQuery：

• Google Analytics
• Cloud Messaging
• Crashlytics
• Performance Monitoring
• A/B Testing
• Remote Config 個人化

所需權限和建議角色

如要查看或管理將資料匯出至 BigQuery 的相關設定，您必須具備資料存取資格。

如果沒有必要的 Firebase 存取權，可以要求 Firebase 專案擁有者透過 Firebase 控制台的身分與存取權管理設定，指派適用的角色給您。如果您對存取 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 AND resourcemanager.projects.getIamPolicy AND resourcemanager.projects.setIamPolicy	擁有者 Firebase 管理員 AND 服務使用情形管理員 AND 專案 IAM 管理員	Google Analytics： 已連結Google Analytics資源的帳戶管理員或編輯者 請參閱下方附註。
為特定 Firebase 應用程式啟用匯出功能	firebase.links.update	擁有者 Firebase 管理員	Google Analytics： 已連結Google Analytics資源的帳戶管理員或編輯者 請參閱下方附註。
停用特定 Firebase 應用程式的匯出功能	firebase.links.update	擁有者 Firebase 管理員	Google Analytics： 已連結Google Analytics資源的帳戶管理員或編輯者 請參閱下方附註。

注意： 如要在 Google Analytics 使用者介面中啟用或停用匯出功能，您必須具備已連結 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. 按一下 ，然後選取「專案設定」。

3. 選取「整合」分頁標籤。

4. 在 BigQuery 整合資訊卡上，按一下「連結」。

5. 按照畫面上的指示設定匯出至 BigQuery。

取消連結「BigQuery」

取消連結 BigQuery 後，系統不會再將資料填入 BigQuery 中對應的資料集。

請留意下列事項：

• 已匯出至「BigQuery」的資料會保留一段時間 (視情況而定)，且可能仍須支付儲存空間和查詢費用。如要避免產生後續費用，可以手動刪除資料集。

• 如果將 BigQuery 資料儲存在其他服務，這類內容可能會受到其他資料保留條款的規範。

您可以在 Firebase 專案層級、產品層級，或特定產品的應用程式層級取消連結 BigQuery。

注意：取消 Firebase 專案與 BigQuery 的連結後，系統會停止從您設定匯出至 BigQuery 的任何 Firebase 產品 (以及適用的 Google Analytics) 匯出所有資料。

如要取消連結 BigQuery，請按照下列步驟操作：

1. 前往 Firebase 控制台的「整合」頁面。

2. 在 BigQuery 資訊卡中，按一下「管理」。

3. 選擇取消連結特定產品，或取消連結特定產品的特定應用程式。

   如要完全取消連結 Firebase 專案，請在頁面底部找到相關按鈕。

4. 系統顯示提示時，請確認要停止匯出。

---

啟用匯出功能後會發生什麼事？

• 選取資料集位置。建立資料集後，該資料集的位置就無法再變更，不過您可以將資料集複製到其他位置，或將資料集手動移動 (重新建立) 至其他位置。詳情請參閱「變更現有匯出作業的位置」。

  這個位置只適用於匯出至 BigQuery 的資料，不會影響儲存於 Firebase 控制台的資料位置。

  注意： 預設情況下，Google Analytics、Cloud Messaging 和 Performance Monitoring 都能選取及變更資料匯出位置。如果是 Crashlytics，只有在 2024 年 10 月中旬後啟用匯出功能，或是升級至新的匯出基礎架構，才能選取及變更匯出位置。

• 根據預設，您專案中所有的應用程式都會連結至 BigQuery，您之後才加進專案的應用程式也統統會自動與 BigQuery 連結。此外，您可以控管該讓哪些應用程式傳送資料。

• Firebase 會將現有資料副本匯出至 BigQuery。資料最多可能需要 48 小時才會完成初始傳播，以便匯出。

• Firebase 會設定每日將資料同步至 BigQuery。

  • 連結專案後，通常需要等到隔天同步處理，第一組資料才會匯出至 BigQuery。

  • 無論您在 BigQuery 中設定的排定匯出作業為何，系統每天都會執行一次每日同步作業。請注意，同步作業的時間和持續時間可能會變更，因此不建議根據匯出作業的特定時間安排下游作業或工作。

  注意： 將 Google Analytics 資料匯出至 BigQuery 的每日上限為 100 萬個事件。您可以使用事件篩選功能來限制匯出的事件數量。如要瞭解詳情，請參閱「篩選資料」。Google Analytics 360 使用者則無數量上限。

---

變更現有匯出資料的位置

為匯出至 BigQuery 設定產品並建立資料集後，就無法變更該資料集的位置。不過，您可以將現有資料集複製到位置不同的新資料集，然後將資料匯出作業重設到新位置。瞭解BigQuery資料集位置。

注意： 變更資料匯出位置的功能預設適用於 Google Analytics、Cloud Messaging 和 Performance Monitoring。如果是 Crashlytics，只有在 2024 年 10 月中旬後啟用匯出功能，或是升級至新的匯出基礎架構，才能選取並變更匯出位置。

請務必按照這些程序中的所有指示操作，否則可能會遺失資料。

選取要變更資料匯出位置的產品

Google Analytics

如要變更現有 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. 選取要啟用匯出功能的應用程式。

雲端通訊

如要變更現有 Cloud Messaging 匯出作業的位置，請按照下列指示操作：BigQuery

1. 前往 Firebase 控制台的「整合」頁面。接著，按照下列步驟操作：

   1. 在 BigQuery 資訊卡中，按一下「管理」。
   2. 將 Cloud Messaging 滑桿切換為關閉，即可停用 BigQuery。

2. 前往 Google Cloud 控制台的 BigQuery 頁面。 接著，按照下列步驟操作：

   1. 建立臨時資料集，儲存原始資料集的現有資料副本。為臨時資料集指派不同於原始資料集名稱的名稱。
   2. 複製或移動原始資料集中的資料到臨時資料集。
   3. 刪除原始資料集。
   4. 建立與原始資料集 (firebase_messaging) 同名的新永久資料集，然後選取新區域。
   5. 將臨時資料集中的資料複製或移至新資料集，然後刪除臨時資料集。

3. 返回 Firebase 控制台和 BigQuery 卡片。 接著，按照下列步驟操作：

   1. 將 Cloud Messaging 滑桿切換為開啟，即可重新啟用 BigQuery 整合功能。
   2. 選取要啟用匯出功能的應用程式。

4. 返回 Google Cloud 控制台和BigQuery 頁面，確認已為新區域中的 Cloud Messaging 建立轉移設定。

Crashlytics

重要事項： 只有在 2024 年 10 月中旬後啟用匯出功能，或是升級至新版匯出基礎架構，才能選取及變更資料匯出位置。

Crashlytics

如要變更現有 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 建立轉移設定。

效能監控

如要變更現有 Performance Monitoring 匯出作業的位置，請按照下列指示操作：BigQuery

1. 前往 Firebase 控制台的「整合」頁面。接著，按照下列步驟操作：

   1. 在 BigQuery 資訊卡中，按一下「管理」。
   2. 將 Performance Monitoring 滑桿切換為關閉，即可停用 BigQuery。

2. 前往 Google Cloud 控制台的 BigQuery 頁面。 接著，按照下列步驟操作：

   1. 建立臨時資料集，儲存原始資料集的現有資料副本。為臨時資料集指派不同於原始資料集名稱的名稱。
   2. 複製或移動原始資料集中的資料到臨時資料集。
   3. 刪除原始資料集。
   4. 建立與原始資料集 (firebase_performance) 同名的新永久資料集，然後選取新區域。
   5. 將臨時資料集中的資料複製或移至新資料集，然後刪除臨時資料集。

3. 返回 Firebase 控制台和 BigQuery 卡片。 接著，按照下列步驟操作：

   1. 將 Performance Monitoring 滑桿切換為開啟，即可重新啟用 BigQuery 整合功能。
   2. 選取要啟用匯出功能的應用程式。

4. 返回 Google Cloud 控制台和BigQuery 頁面，確認系統已為新區域中的 Performance Monitoring 建立轉移設定。

---

定價和 BigQuery 沙箱

如果 Firebase 專案採用免付費的 Spark 定價方案，您可以使用BigQuery 沙箱，免費存取 BigQuery。如要瞭解 BigQuery 沙箱及其功能，請參閱「使用 BigQuery 沙箱」。

如果 Firebase 專案採用即付即用 Blaze 定價方案，即可使用 BigQuery 的所有功能。使用 BigQuery 時須遵守BigQuery 定價，包括免付費使用上限。