测试版连接 HubSpot 和 AWS S3

连接 HubSpot 和 AWS S3，将 HubSpot 数据同步到 S3 存储桶。连接应用程序后，HubSpot 可以将 CRM 数据（包括对象、记录、关联、事件和分段）同步到 AWS S3，以便进行存储、报告和分析。 

例如，您可以将联系人和公司数据同步到 S3 存储桶，并将其用于组织的数据仓库、商业智能工具或数据处理工作流。

请注意： HubSpot 不会 将 HIPAA 数据共享到 AWS S3。

开始之前

在设置集成之前，您需要将 您的 HubSpot 帐户选入 AWS S3 测试版 中的 Access HubSpot 数据 。

连接 HubSpot 和 AWS S3

要连接 HubSpot 和 AWS S3，必须按以下步骤依次进行： 

1. 配置 AWS S3 存储桶的访问权限。 
2. 创建 IAM 策略。 
3. 在 AWS 中创建 IAM 角色。 
4. 连接 HubSpot 和 AWS S3。 
5. 授予 IAM 用户访问 S3 存储桶对象的权限。 

1.配置 S3 存储桶的访问权限

HubSpot 需要 AWS S3 存储桶和文件夹的以下权限，才能访问文件夹和子文件夹中的文件：

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:PutObject
• s3:DeleteObject

2.创建 IAM 策略

1. 登录 AWS 管理控制台。
2. 在主控制面板上，单击服务 > Security, Identity, & Compliance > IAM。
3. 在左侧边栏点击账户设置。
4. 在安全令牌服务（STS） 部分，查找与您的 AWS 账户所在区域相对应的 AWS 区域。点击 打开 开关，激活该区域。
5. 在左侧面板上单击 "政策"。 
6. 单击创建策略。 
7. 在JSON 选项卡上，单击 添加新语句。 
8. 添加下面的策略文档，为 HubSpot 提供使用单一桶和文件夹路径加载或卸载数据所需的权限。您还可以使用 PURGE 复制选项清除数据文件。 

{
 "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>/*"
 ]
 }
 }
 }
 ]}

9. 单击下一步。
10. 在"审查和创建 " 部分，添加 政策名称 和可选说明。
11. 单击创建策略。 

3.在 AWS 中创建 IAM 角色

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

1. 登录 AWS 管理控制台。
2. 在主控制面板上，单击服务 > Security, Identity, & Compliance > IAM。
3. 在左侧边栏单击 "角色"。 
4. 单击创建角色。 
5. 在受信任实体类型 部分，选择AWS 账户。
6. 在 "一个 AWS 账户 "部分，选择 "另一个 AWS 账户 "并输入您自己的 AWS 账户 ID。稍后，您将更改信任关系，以便访问 HubSpot。 
7. 选择 "要求外部 ID "，然后输入一个占位符 ID，如 0000。稍后，您将更改 IAM 角色的信任关系，并为存储集成指定外部 ID。外部 ID 用于授予 HubSpot 等第三方应用程序访问 AWS 资源的权限。 

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

4.连接 HubSpot 和 AWS S3

1. 在 HubSpot 帐户中，单击顶部导航栏中的“商城”图标 ，然后选择 HubSpot 商城。
2. 搜索并选择 AWS S3。 
3. 点击 安装。 
4. 输入在步骤 3 中配置的 IAM 角色名称 和要存储数据的存储桶的S3 URL 路径 。
5. 单击 下一步。
6. 查看并复制 AWS IAM 用户 和 AWS 外部 ID 值，因为下一步会用到它们。然后，单击 " 继续连接应用程序"。

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

1. 登录 AWS 管理控制台。
2. 在主控制面板上，单击服务 > Security, Identity, & Compliance > IAM。
3. 在左侧边栏中，单击 "角色"。
4. 选择在步骤 3 中创建的角色。 
5. 选择 "信任关系 "选项卡，然后单击 "编辑信任策略"。 
6. 用步骤 3 中记录的值修改保单文件。 

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

7. 在上述策略中，将以下两个字段更改为步骤 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 联系人和公司细分。
• 所有者：有 记录的所有者。 
• 管道： 交易和票据管道以及管道阶段。 
• 属性： 对象记录上的属性及其值，包括属性历史记录。 

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

• 单个： 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 和 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

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