请注意：：本文仅为方便您阅读而提供。

在 Google BigQuery 中访问 HubSpot 数据（BETA）

上次更新时间： 2026年6月1日

可与以下任何订阅一起使用，除非另有说明：

Data Hub Enterprise

将 Google BigQuery 连接到您的 HubSpot 账户后，您就可以在 BigQuery 中查询 HubSpot 数据了。

本文提供了同步到 BigQuery 的每张表的架构信息，您可以结合Google 的文档，在您的 BigQuery 账户中查询 HubSpot 数据。

数据概述

查询使用 SQL 构建，可用于检索以下 HubSpot 数据：

对象：标准 和自定义对象，例如联系人、公司、产品。
记录：单个 记录，例如单个联系人或公司。
关联：所有可用的关联类型以及当前关联的记录。
事件：包含标准 HubSpot 事件（如邮件打开）和自定义行为事件的事件数据。

v1 版本中，不同类型的对象数据会被合并：所有对象类型的所有记录都会合并到一个数据库对象中。因此，在查询时，您需要指定类似“WHERE objectTypeId=’0-1’”的过滤条件。

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

了解更多关于 HubSpot 的 CRM 数据模型。

同步的表结构

以下各节详细介绍了根据您配置的同步设置，从您的 HubSpot 账户同步到 BigQuery 的每个表的架构。

object_properties 架构

以下架构详细说明了已同步的 object_properties 表：

列名	类型	描述
OBJECTTYPEID	字符串	对象类型的 ID（例如，联系人的 ID 为 0-1）。
OBJECTID	INT64	记录的 ID（例如，123752 作为示例联系人记录）。
NAME	STRING	属性的名称。
VALUE	JSON	属性的值
更新时间	TIMESTAMP	该记录在 HubSpot 中最后更新的日期和时间。
INGESTEDAT	时间戳	该记录最后一次被 BigQuery 导入的日期和时间。

object_with_object_properties 架构

以下架构提供了同步的 object_with_object_properties 表的详细信息：

列名	类型	描述
OBJECTTYPEID	字符串	对象类型的 ID（例如，联系人的 ID 为 0-1）。
OBJECTID	INT64	记录的 ID（例如，123752 作为示例联系人记录）。
PROPERTIES	JSON	记录的属性值
UPDATEDAT	TIMESTAMP	该记录在 HubSpot 中最后更新的日期和时间。
INGESTEDAT	时间戳	该记录最后一次被 BigQuery 导入的日期和时间。

associations_x_to_y 架构

以下架构提供了已同步的 associations_x_to_y_ 表的详细信息：

列名	类型	描述
COMBINEDASSOCIATIONTYPEID	字符串	特定关联定义的唯一标识符。
关联类别	字符串	关联类型的来源。可能的值包括：HUBSPOT_DEFINED、USER_DEFINED 或 INTEGRATOR_DEFINED。
关联类型 ID	字符串	关联定义在其 ASSOCIATIONCATEGORY 内的唯一标识符。同一类别中不存在两个定义共享此 ID。
源对象类型ID	字符串	关联源对象的对象类型ID。
FROMOBJECTTYPE	字符串	关联源对象类型的名称。
目标对象类型 ID	字符串	关联目标对象的对象类型 ID。
TOOBJECTTYPE	字符串	关联目标对象类型的名称。
NAME	字符串	关联定义的定义名称。
LABEL	字符串	关联定义的描述性标签。
ISMAINASSOCIATIONDEFINITION	布尔值	指示此关联类型是否为主关联类型（true），即 HubSpot 在关联记录上显示的关联类型。
[FROMOBJECTTYPE_OBJECTID]	INT64	源记录的对象 ID。（例如，对于 ASSOCIATIONS_CONTACTS_TO_DEALS 视图，为 CONTACT_OBJECTID）。
[TOOBJECTTYPE_OBJECTID]	INT64	目标记录的对象 ID。（例如，对于 ASSOCIATIONS_CONTACTS_TO_DEALS 视图，为 DEAL_OBJECTID）。
INGESTEDAT	TIMESTAMP	BigQuery 最后一次摄入该记录的日期和时间。

associations 模式

以下架构提供了已同步的 associations 表的详细信息：

列名	类型	描述
组合关联类型ID	字符串	关联定义的唯一标识符。
FROMOBJECTID	INT64	源对象的 ID。
TOOBJECTID	INT64	目标对象的 ID。
INGESTEDAT	TIMESTAMP	BigQuery 最后导入该记录的日期和时间。

association_definitions 模式

以下架构提供了已同步的 associations_definitions 表的详细信息：

列名	类型	描述
COMBINEDASSOCIATIONTYPEID	字符串	特定关联定义的唯一标识符。
关联类别	字符串	关联类型的来源。可能的值包括：HUBSPOT_DEFINED、USER_DEFINED 或 INTEGRATOR_DEFINED。
关联类型 ID	字符串	关联定义在其 ASSOCIATIONCATEGORY 内的唯一标识符。同一类别中不存在两个具有相同 ID 的定义。
源对象类型ID	字符串	关联源对象的对象类型ID。
FROMOBJECTTYPE	字符串	关联源对象类型的名称。
目标对象类型 ID	字符串	关联目标对象的对象类型 ID。
TOOBJECTTYPE	字符串	关联目标对象类型的名称。
NAME	字符串	关联定义的定义名称。
LABEL	字符串	关联定义的描述性标签。
ISMAINASSOCIATIONDEFINITION	布尔值	指示此关联是否为主关联类型（true），即 HubSpot 在关联记录上显示的关联类型。
INGESTEDAT	时间戳	BigQuery 最后一次摄入该记录的日期和时间。

事件

事件包括标准 HubSpot 事件和自定义行为事件。每个事件都有其对应的数据库对象，命名为events_eventname。

名称
EVENTS_AD_INTERACTION	广告的详细信息，以及通过点击广告或在与广告互动后提交表单与其进行交互的联系人。
EVENTS_AD_METRICS_IMPORTED_V0	广告及其绩效指标的详细信息。
EVENTS_CALL_MENTIONED_KEYWORD	通话中任何参与者提及的关键词详情。
EVENTS_CLICKED_LINK_IN_EMAIL_V2	联系人点击营销邮件中的链接。
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	联系人点击“对话”收件箱邮件中的链接。
EVENTS_COOKIE_BANNER_CLICKED	点击了 Cookie 横幅的联系人。
EVENTS_COOKIE_BANNER_VIEWED	查看了 Cookie 的联系人。
EVENTS_DOCUMENT_SHARED_V2	通过外部链接与联系人共享的销售文档。
EVENTS_DOCUMENT_VIEWED_V2	通过打开外部链接查看销售文档的联系人。
EVENTS_DOCUMENT_COMPLETED_V2	已关闭的销售文档及其对应的联系人。
EVENTS_HS_SCHEDULED_EMAIL_V2	已提交至 HubSpot 邮件服务器待发送的邮件。
EVENTS_MTA_DELIVERED_EMAIL_V2	已由 HubSpot 邮件服务器成功投递给收件人的邮件。
EVENTS_MTA_BOUNCED_EMAIL_V2	被收件人邮件服务器拒绝的邮件投递尝试。
EVENTS_OPENED_EMAIL_V2	联系人打开了电子邮件。
EVENTS_REPORTED_SPAM_EMAIL_V2	被收件人标记为垃圾邮件的电子邮件。
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	收件人更改了电子邮件订阅状态。
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	联系人打开 Conservations 收件箱邮件的情况。
EVENTS_MB_MEDIA_PLAYED	联系人视频播放活动。
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	联系人通过序列预约了会议。
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	联系人已加入序列。
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	序列已完成。
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	联系人回复了通过序列发送的电子邮件（或导致退出序列的收到的电子邮件）。
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	联系人已从序列中退订。
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	用户手动将联系人从序列中取消订阅。
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	联系人已取消订阅，退出序列。
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	序列邮件被退回。
EVENTS_V2_SEQUENCE_ERRORED	序列发生错误，导致退订。
EVENTS_V2_SEQUENCE_STEP_EXECUTED	序列步骤已执行。
EVENTS_VISITED_PAGE	联系人访问网站页面。
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	集成事件（Timeline V3 API）

您可以通过结合事件类型 ID 和 ID 来识别事件。返回的列取决于事件本身，每个事件属性对应一列。所有事件都会返回以下列：

列名	类型	描述
`EVENTTYPEID`	字符串	事件类型的 ID，类似于 OBJECTTYPEID 您可以使用object_and_event_type_definitions视图查询您账户中的所有事件类型 ID。
`ID`	字符串	该 ID 在每个事件类型中是唯一的。在给定的事件类型内，不会有两个记录具有相同的 ID。
`OBJECTTYPEID`	字符串	触发该事件的对象类型。例如，电子邮件链接点击事件在此列中会显示`0-1`，代表联系人对象。
`OBJECTID`	INT64	完成该事件的记录的 ID。
`OCCURREDAT`	TIMESTAMP	事件发生的时间。
`OCCURREDATDATEINT`	INT64	一个表示事件发生时间的数字。包含与`OCCURREDAT`列相同的数据，但格式为数字，并用作表的集群键的一部分。在大多数情况下，您可以使用`OCCURREDAT`时间戳来代替此数字。
`OCCUREDATDATEINT`	数字	一个表示事件发生时间的数字。包含与`OCCURREDAT`列相同的数据，但格式为数字，并用作表的集群键的一部分。在大多数情况下，您可以使用`OCCURREDAT`时间戳来代替此数字。
`INGESTEDAT`	时间戳	BigQuery 最后一次摄入该数据的日期和时间。了解有关列数据类型的更多信息。
`PROPERTY_*`	Varchar	包含事件属性的各个列。

这篇文章有帮助吗？

此表单仅供记载反馈。了解如何获取 HubSpot 帮助。

测试版在 Google BigQuery 中访问 HubSpot 数据（BETA）