将项目数据导出到 BigQuery

您可以使用 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	Owner Firebase Admin	无
解除 Firebase 项目与 BigQuery 的关联	firebase.links.delete	Owner Firebase Admin	无
查看 BigQuery 的现有关联	firebase.links.list	任何基本角色（Owner、Editor 或 Viewer） 任何 Firebase 级角色 任何 Firebase 产品类别角色	无

Google Analytics（分析）

下表专门适用于将 Google Analytics（分析）数据导出到 BigQuery 的操作。

Firebase 控制台中的操作	所需的 IAM 权限	默认包含所需权限的 IAM 角色	其他必需的角色
启用将 Google Analytics（分析）数据导出到 BigQuery 的功能	firebase.links.update 和 serviceusage.services.enable	Owner Firebase Admin 和 Service Usage Admin	Google Analytics（分析）：相当于关联的 Google Analytics（分析）媒体资源的帐号 Administrator 或 Editor 请参阅下文的备注。
为特定 Firebase 应用启用导出功能	firebase.links.update	Owner Firebase Admin	Google Analytics（分析）：相当于关联的 Google Analytics（分析）媒体资源的帐号 Administrator 或 Editor 请参阅下文的备注。
为特定 Firebase 应用停用导出功能	firebase.links.update	Owner Firebase Admin	Google Analytics（分析）：相当于关联的 Google Analytics（分析）媒体资源的帐号 Administrator 或 Editor 请参阅下文的备注。

注意：如需在 Google Analytics（分析）界面中启用或停用导出功能，您需要拥有针对关联的 Google Analytics（分析）媒体资源的明确 Administrator 或 Editor 角色，但不一定要拥有 Firebase 访问权限。

Firebase 产品

下表适用于可以向 BigQuery 导出其数据的任何 Firebase 产品，例如 Crashlytics 或 Performance Monitoring。

Firebase 控制台中的操作	所需的 IAM 权限	默认包含所需权限的 IAM 角色	其他必需的角色
启用将产品数据导出到 BigQuery 的功能	firebase.links.update	Owner Firebase Admin	无
为特定 Firebase 应用启用导出功能	firebase.links.update	Owner Firebase Admin	无
为特定 Firebase 应用停用导出功能	firebase.links.update	Owner Firebase Admin	无

启用 BigQuery Export

1. 进入 Firebase 控制台的集成页面。

2. 在 BigQuery 卡片中，点击关联。

3. 按照屏幕上的说明启用 BigQuery。

注意：Google Analytics（分析）数据导出到 BigQuery 的量每天不能超过 100 万个事件。您可以使用事件过滤功能来限制导出的事件数量。如需了解详情，请参阅数据过滤。Google Analytics 360 用户无限制。

为 Google Analytics（分析）、Performance Monitoring 或 Cloud Messaging 启用 BigQuery 导出功能后：

• 请选择数据集区域。创建数据集后，将无法更改其位置，但可以将数据集复制到其他位置，或手动将数据集移动（重新创建）到其他位置。如需了解详情，请参阅更改数据集位置。

  注意：只有 Google Analytics（分析）、Performance Monitoring 和 Cloud Messaging 支持选择数据集区域。Crashlytics 仅支持将数据导出到美国。

• 默认情况下，您项目中的所有应用都会关联到 BigQuery，而且您以后向项目中添加的所有应用也都会自动关联到 BigQuery。您能控制哪些应用可发送数据。 Google Analytics（分析）中来自 Google Analytics（分析）4 媒体资源的所有网站数据也会自动导出。

• Firebase 会将您的现有数据的副本导出到 BigQuery。

• Firebase 会安排每日将您的数据从 Firebase 项目同步到 BigQuery。

如需停用 BigQuery 导出功能，请在 Firebase 控制台中解除与您的项目的关联。

更改数据集位置

为产品启用 BigQuery 导出功能并创建数据集后，将无法更改该数据集的位置。不过，您可以将现有数据集复制到不同位置中的新数据集。

注意：只有 Google Analytics（分析）、Performance Monitoring 和 Cloud Messaging 支持选择数据集区域。Crashlytics 仅支持将数据导出到美国。

如需了解 BigQuery 数据集位置，请参阅数据集位置。

选择要更改数据集位置的产品。

注意：请务必遵循这些过程中的所有说明；忽略某个步骤可能会导致数据丢失。

Google Analytics（分析） Performance Monitoring Cloud Messaging

如需更改 Cloud Messaging 数据集的位置，请按照以下说明操作：

1. 在 Firebase 控制台中转到集成页面。
2. 在 BigQuery 卡片中，点击管理。
3. 关闭 Cloud Messaging 滑块以停用 BigQuery。
4. 在 Google Cloud 控制台中转到 BigQuery 页面。
5. 创建一个临时数据集，以存储原始数据集中现有数据的副本。为临时数据集指定与原始数据集不同的名称。
6. 将数据从原始数据集复制或移动到临时数据集。
7. 删除原始数据集。
8. 创建一个与原始数据集 (firebase_messaging) 同名的新永久数据集，然后选择所需的区域。
9. 将数据从临时数据集复制或移动到新数据集，然后删除临时数据集。
10. 对于新数据集，点击共享标签页，然后选择权限。 然后添加 [e-mail] 主帐号作为 BigQuery 数据所有者。
11. 转到 Firebase 控制台并开启 Cloud Messaging 滑块，以重新启用 BigQuery。然后，选择要为其启用导出功能的应用。
12. 转到 Google Cloud 控制台中的 BigQuery 页面，验证已在新区域中为 Cloud Messaging 创建转移配置。

价格和 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 价格收费，其中包含有限的免费使用额度。