测试版将 HubSpot 连接到 Google BigQuery

将 Google BigQuery 中的数据与 HubSpot CRM 对象同步，如联系人、公司、交易、关联以及账户中的其他数据。

下面的章节将向你介绍如何授权Google BigQuery应用程序，然后配置Google云账户和HubSpot之间的同步设置。

连接并配置谷歌BigQuery集成

将 Google BigQuery 账户连接到 HubSpot：

1. 在 HubSpot 帐户中，单击顶部导航栏中的“商城”图标 ，然后选择 HubSpot 商城。
2. 点击搜索栏并输入Google BigQuery。
3. 单击列表页面中的Google BigQuery 。
4. 单击安装。
5. 单击继续设置。

你将被重定向到数据集成工具，在该工具的侧窗格中，将根据你要同步的方向，指导你在HubSpot和BigQuery账户之间同步数据：

• Google BigQuery → HubSpot：配置从BigQuery到HubSpot的同步。
• HubSpot → Google BigQuery：配置从HubSpot到BigQuery的同步。

将Google BigQuery数据同步到HubSpot账户

要将 Google BigQuery 数据发送到 HubSpot，请在 BigQuery 帐户中添加并配置一个具有所需角色的新用户：

1. 在右窗格中，选择Google BigQuery → HubSpot。
2. 复制 HubSpot 生成的 Google 服务帐户电子邮件。

3. 在 Google Cloud 帐户中，导航到项目 IAM 设置，使用从 HubSpot 复制的服务帐户电子邮件创建一个新用户，然后为新创建的用户添加BigQuery 数据查看器 和BigQuery 作业用户角色。

4. 从 Google 云账户复制项目 ID。
5. 回到 HubSpot，粘贴项目 ID，然后单击测试连接。
6. 连接验证后，单击 "下一步 " 完成设置。

将HubSpot数据同步到Google BigQuery账户

要将HubSpot数据发送到Google BigQuery，你需要在Google云账户中配置一个具有所需权限的用户，同时指定相关的GCP项目和GCS水桶URI。

请注意：您需要Google Cloud管理员访问BigQuery数据集所在的GCP项目和HubSpot存放Parquet文件的Google Cloud Storage (GCS)存储桶。

1. 在右窗格中，选择HubSpot → Google BigQuery。
2. 复制 HubSpot 生成的 Google 服务帐户电子邮件。

3. 在 Google Cloud 帐户中，导航到项目 IAM 设置，使用从 HubSpot 复制的服务帐户电子邮件创建新用户，然后为新创建的用户添加BigQuery 数据查看器、BigQuery 作业用户和存储对象所有者角色。
   

4. 从 Google 云账户复制项目 ID。
5. 返回 HubSpot，粘贴项目 ID。
6. 添加您的 Google Cloud Storage (GCS) 存储桶 URI：
   • GCS 存储桶的 URI 应遵循以下结构：gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • BigQuery 外部表在 GCP 项目的专用数据集中创建，并遵循以下格式：hubspot_data_set_{hubId}
   • 数据将被写入 GCS 数据桶，相关表将引用 GCS 中的 parquet 文件。
   • 在 Google文档中了解有关创建 GCS 桶的更多信息。
7. 单击测试连接。
8. 验证连接后，单击下一步。
9. 选择要同步的数据源（如联系人、关联、事件等）旁边的复选框。
10. 配置同步频率和日程。
11. 单击开始同步。

监控同步

配置账户之间的同步后，可以从同步详细信息页面查看同步状态和历史记录：

1. 在 HubSpot 帐户中，导航到数据管理 > 数据集成。 查看同步状态和历史记录。
2. 在监控导入和同步下，单击应用程序同步选项卡。
3. 单击搜索栏并搜索Google BigQuery。
4. 单击Google BigQuery。注意，如果配置了双向同步，可能会出现多个条目。
5. 在同步详细信息页面，你可以管理和查看同步设置和历史记录：
   • 要存档或编辑同步详细信息，请在右上角单击 "操作"，然后选择相应选项。
   • 要立即触发同步，请在右上角单击立即 同步。
   • 页面顶部汇总了同步记录、关联和错误。
   • 最近的同步活动将显示在表格中。单击 "同步历史"选项卡可查看特定的同步尝试和完成情况。您可以按特定日期范围或同步状态进行筛选。

同步状态和错误处理

下表概述了可能的同步状态：

如果同步失败：

• 同步详细信息页面上将显示 "失败 "状态，以及哪些表同步成功或失败的信息。
• 失败时不会写入部分数据：BigQuery 表仅在成功完成同步后才会更新。
• 下一次计划的同步将自动重新尝试完全同步。
• 您可以随时从同步详细信息页面手动触发重新同步。

网络允许列表

将HubSpot数据同步到BigQuery等第三方提供商是通过HubSpot的代理IP进行的。这些IP范围被其他HubSpot集成使用，如数据同步和网络钩子。

如果您的组织限制对 GCP 资源的入站访问，则应根据您的 HubSpot hublet 允许列出以下 CIDR 范围：

了解如何查找HubSpot 账户数据的托管位置。

测试版限制

在测试阶段请注意以下限制：

• 同步频率：只提供有限的一组同步频率，包括一次、每 6 小时一次、每 12 小时一次、每天一次、每周一次和每月一次。您可以随时从 HubSpot 的同步详细信息页面手动触发重新同步。
• 每种数据类型 只能导出一次： 每个对象类型、事件类型或关联对只能在每个 HubSpot 帐户的一个同步配置中导出。
  
  • 例如，如果联系人已经导出到一个BigQuery目的地，那么在原始目的地存档之前，就不能将其添加到第二个配置中。
  • 这可以防止重复的数据管道，并确保数据仓库中每种数据类型都有单一的真实来源。
• 有限的敏感数据支持：您可以将敏感数据存储和同步到您的HubSpot账户，但不能将敏感数据同步到您的BigQuery账户。
• 不支持object_x_views：目前不支持object_x_views对象与BigQuery同步。请使用object_with_object_properties ，或将objects 与object_properties 连接，以获得等效的每记录视图。

下一步

连接 BigQuery 集成并设置同步设置后，了解BigQuery 中同步表的模式。