连接 HubSpot 和 AWS S3（BETA）

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Effect": "Allow",
 "Action": [
 "s3:PutObject",
 "s3:GetObject",
 "s3:GetObjectVersion",
 "s3:DeleteObject",
 "s3:DeleteObjectVersion"
 ],
 "Resource": "arn:aws:s3:::<bucket>/<prefix>/*"
 },
 {
 "Effect": "Allow",
 "Action": [
 "s3:ListBucket",
 "s3:GetBucketLocation"
 ],
 "Resource": "arn:aws:s3:::<bucket>",
 "Condition": {
 "StringLike": {
 "s3:prefix": [
 "<prefix>/*"
 ]
 }
 }
 }
 ]
}

• 单击下一步。
• 在审查和创建部分，添加策略名称和可选描述。
• 单击创建策略。

3.在 AWS 中创建 IAM 角色

在 AWS 管理控制台中配置 HubSpot 的访问权限：

• 登录AWS 管理控制台。
• 在主控制面板上，单击服务>安全、身份和合规性 >IAM。
• 在左侧边栏中，单击角色。
• 单击创建角色。
• 在受信任实体类型部分，选择AWS 帐户。
• 在 "一个 AWS 账户"部分，选择 "另一个 AWS账户"，然后输入您自己的 AWS 账户 ID。稍后您将更改信任关系，以便向 HubSpot 提供访问权限。
• 选择 "要求外部 ID"并输入占位符 ID，如 0000。稍后您将更改 IAM 角色的信任关系，并为存储集成指定外部 ID。外部 ID 用于授予第三方应用程序（如 HubSpot）访问 AWS 资源的权限。

• 单击下一步。
• 选择在步骤 1 中创建的策略，然后单击下一步。
• 在 "角色详细信息"部分，输入角色名称和描述以标识角色。
• 单击创建角色。
• 在 "角色摘要 "页面，复制ARN值。您将在下一步中使用该值。

4.连接 HubSpot 和 AWS S3

• 在你的 HubSpot 帳戶中，點擊頂端導覽列中的「Marketplace 圖示」marketplace，然後選取「App Marketplace」。搜索并选择AWS S3。您也可以使用此 URL 直接导航到您账户中的集成。
• 在右上角，单击安装应用程序。
• 输入在步骤 3 中配置的IAM 角色名称 和要将数据转储到的数据桶的S3 URL 路径。
• 单击下一步。
• 查看并复制AWS IAM 用户和 AWS 外部 ID 值，因为下一步中需要它们。然后，单击 "继续连接应用程序"。

5.授予 IAM 用户访问水桶对象的权限

• 登录AWS 管理控制台。
• 在主控制面板上，单击服务>安全、身份和合规性 >IAM。
• 在左侧边栏中，单击角色。
• 选择在步骤 3 中创建的角色。
• 选择 "信任关系"选项卡，然后单击 "编辑信任策略"。
• 用步骤 3 中记录的值修改策略文档。

{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"AWS": "<hubspot_user_arn>"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"sts:ExternalId": "<hubspot_external_id>"
}
}
}
]
}

在上述策略中，将以下两个字段更改为步骤 4 中记录的值：

• hubspot_user_arn为STORAGE_AWS_IAM_USER_ARN值
• hubspot_external_id为STORAGE_AWS_EXTERNAL_ID 值

完成上述步骤后，HubSpot 就可以将数据同步到 AWS S3。

在 HubSpot 和 AWS S3 之间同步的数据格式

可用的同步数据

您可以将以下数据从 HubSpot 同步到 AWS S3：

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

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

• 单个： 每个对象类型存储在自己的表中，并且只有相同对象类型的记录。例如，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 和 AWS S3 之间同步。数据同步的每一天都会创建一个文件夹。以下每个表格都将以文件夹形式提供，其中包含压缩后的 CSV 文件：

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

每个表格将有多个子文件夹。如果表格大小超过 15MB，则每个表格文件夹下会有多个压缩 CSV 文件。