连接 HubSpot 和 Google BigQuery

了解如何连接 HubSpot 和 Google BigQuery，以便将 HubSpot 数据同步到 Google BigQuery 实例。

请注意： HubSpot 不会 向 Google BigQuery 共享 HIPAA 数据。

连接 HubSpot 和 BigQuery

要连接 HubSpot 和 Google BigQuery，必须依次完成以下步骤：

1. 从 HubSpot 应用程序市场安装 Google BigQuery。
2. 在 Google Cloud Platform 中创建自定义 IAM 角色。
3. 将自定义角色分配给 Google 服务帐户。
4. 授予 HubSpot 生成的 Google BigQuery 账户修改 BigQuery 表的权限。
5. 在 HubSpot 中完成设置。

1.从 HubSpot 应用程序市场安装 Google BigQuery

在连接这两个应用程序时，建议在不同的标签页中分别打开 HubSpot 帐户和 Google BigQuery 帐户。 

1. 确保您的 HubSpot 帐户 已选择加入测试版：在 Google BigQuery 中访问 HubSpot 数据。 
2. 导航 至此链接 并选择您的 HubSpot 账户。 
3. 点击 安装。
4. 输入您的水桶 URI和项目 ID。 
5. 单击下一步。 
6. 查看并记下 Google 服务和 BigQuery 帐户，因为下一步需要它们。然后，导航到 Google Cloud 控制台完成下一步。 

2.在 Google 云平台中创建自定义 IAM 角色

1. 登录 Google Cloud 控制台。 
2. 单击左侧导航菜单，选择IAM & 管理 > 角色。 
3. 在顶部单击 " 创建角色"。
4. 输入角色的标题、 可选 描述和 ID 。 
5. 单击添加权限。 

6. 在表中选择以下权限，然后单击添加：

bigquery.datasets.create
bigquery.datasets.get
bigquery.datasets.getIamPolicy
bigquery.jobs.create
bigquery.tables.create
bigquery.tables.createIndex
bigquery.tables.createSnapshot
bigquery.tables.createTagBinding
bigquery.tables.delete
bigquery.tables.deleteIndex
bigquery.tables.deleteSnapshot
bigquery.tables.update
bigquery.tables.get
storage.buckets.get
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list

7. 单击创建。 

3.授予 Google 服务帐户访问云存储桶的权限

1. 单击左侧导航菜单，选择云存储 > Buckets。 
2. 选择要配置的水桶 。 
3. 单击 " 权限 "选项卡。
4. 在 " 按负责人查看 "选项卡上，单击 " 授予访问权限"。

5. 在右侧面板的 "新委托人 "字段中，输入步骤 1 中的Google 服务账户 名称。

请注意： 确保分配的是 Google 服务帐户，而不是 BigQuery 帐户。

6. 在 "分配角色 "部分，单击 下拉菜单 并选择 自定义 > <role> ，其中 <role> 是在步骤 2 中创建的自定义 IAM 角色。 
7. 单击 保存。Google 服务账户将被添加到存储对象查看器 角色中。 

4.授予 HubSpot 生成的 Google BigQuery 帐户修改 BigQuery 表的权限

1. 单击左侧导航菜单，选择 IAM & Admin > IAM。 
2. 单击 "授予访问权限"。
3. 在右侧面板的 "新委托人 "字段中，输入步骤 1 中 HubSpot 生成的 Google BigQuery 账户 。
4. 在 "分配角色 "部分，单击 下拉菜单 并选择 自定义 > <role> ，其中 <role> 是在步骤 2 中创建的自定义 IAM 角色。 

5.在 HubSpot 中完成设置

1. 回到 HubSpot 账户，单击 " 继续连接应用程序"。 
2. 在对话框中，选择 复选框，然后单击允许并安装。 

在 HubSpot 和 Google BigQuery 之间同步的数据格式

可用的同步数据

您可以将以下数据从 HubSpot 同步到 Google BigQuery： 

• 对象： 标准和自定义对象，如联系人、公司、机票或产品。
• 记录： 单个对象的记录。 
• 关联： 所有关联类型和相关记录。
• 事件： 标准 HubSpot 事件和自定义行为事件的事件数据。 
• 细分： HubSpot 联系人和公司细分。
• 所有者：有 记录的所有者。 
• 管道： 交易和票据管道以及管道阶段。 
• 属性： 对象记录上的属性及其值，包括属性历史记录。 

不同类型的对象数据以两种方式组织和提供：

• 单个： e每个对象类型都存储在自己的表中，并且只有相同对象类型的记录。例如 objects_contacts 只包含联系人记录。
• 合并：将所有对象类型的所有记录合并为一个数据库对象。因此，在查询时，需要指定一个过滤器，如 "WHERE objectTypeId='0-1'

自定义对象将在创建时分配一个 ID，标识为2-unique_ID。例如，2-12345。 

对象_x 表

每种可用对象类型（包括自定义对象）都有自己的特定表格。这些表格的命名格式如下 OBJECTS_<object type name> 其中 <object type name> 是 objecttype注意，如果对象类型没有复数形式，则 <object type name> 将是对象类型名称的单数形式标签，并与 "S "连接）。

下面是可用 HubSpot 对象类型的完整列表、它们所代表数据的简短描述以及相应的表格。

带对象属性的对象

该表包含 HubSpot 记录中的数据。您可以为对象类型中的每条记录获取一条记录（例如，联系人对象类型中的所有联系人记录）。 

对象属性历史

本表包含历史房产价值。对于联系人，它包含最近的 45 个值。对于所有其他对象，它包含最近的 20 个值。表格中的每一个历史属性值都有一行。属性的当前值由属性历史记录中最新的 UPDATEDAT 时间戳决定。

关联查询

与对象数据一样，关联数据也有两种组织方式：

• 单个： 每个关联类型存储在自己的表中，只包含该类型的记录。例如 associations_contacts_to_deals 只包含联系人和交易对象之间的关联记录。T
• 合并： 将所有关联类型的所有记录合并到一个表中。

关联 x_to_y 

每种关联类型都有自己的视图，标记为 associations_<association type name> 例如 associations_contacts_to_deals. 

关联定义

此表包含 HubSpot 对象之间所有可用关联类型的信息，每个关联类型有一行。

属性定义

本表包含有关 HubSpot 账户中对象属性和事件属性的信息。事件属性包括标准事件（如电子邮件打开和点击）和自定义行为事件属性。这些信息有助于定义对象属性和事件数据中的值。

活动

事件包括标准 HubSpot 事件和自定义行为事件。每个事件都有自己的表格，标记为 events_eventname.

对象和事件类型定义

本表包含 HubSpot 账户中所有对象和事件的定义。

同步频率和数据组织

HubSpot 和 Google BigQuery 之间的数据同步工作每天大约在世界协调时上午 6:00 开始。数据同步到 Google BigQuery 所需的时间取决于账户的队列位置和数据量。不保证完成时间。

数据同步的每一天都会创建一个文件夹，每个表都有几个子文件夹。最近的七次同步将在 Google 云平台中提供，BigQuery 中的表也会更新以指向最新的数据包转储。

以下每个表格都将以 Parquet 格式文件提供：

ASSOCIATIONS
ASSOCIATION_DEFINITIONS
EVENTS_[Event name]
LISTS
LIST_MEMBERSHIPS
OBJECTS
OBJECT_AND_EVENT_TYPE_DEFINITIONS
OBJECT_PROPERTIES
OBJECT_PROPERTIES_HISTORY
OBJECT_WITH_OBJECT_PROPERTIES
OWNERS
OWNER_TEAM
PIPELINES
PIPELINE_STAGES
PROPERTY_DEFINITIONS
TEAMS