測試版將資料同步到AWS S3 （舊版）

連結 HubSpot和AWS S3 ，將HubSpot資料同步到S3儲存區。連接應用程式後， HubSpot可以將 CRM 資料（包括對象、記錄、關聯、事件和區段）同步到AWS S3以進行存儲、報告 資料分析。 

例如，您可以將 連絡人 和公司資料同步至S3儲存區，並在組織的資料倉儲、商業智慧工具或 資料處理 工作流程中使用。

請注意： HubSpot 不會 將HIPAA資料分享給AWS S3。

開始之前

在設定 整合 之前，您需要在AWS S3測試版中 選擇將HubSpot 帳戶 加入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. 在首 顯示面板 上，按一下服務 > 安全性、身分識別、 & 法規遵循> IAM。
3. 按一下左側邊欄的「帳戶 。
4. 在Security Token Service (STS)區段中，尋找與您的AWS 帳戶 所在區域相對應的AWS區域。按一下以切換開 關 以啟用區域。
5. 按一下左側面板的「政策」。 
6. 按一下「建立政策」。 
7. 在「JSON 」索引標籤上，按一下「新增帳單明細」 
8. 在下方新增原則文件，授予HubSpot使用單一儲存區和資料夾路徑載入或卸載資料所需的權限。您也可以使用「清除複製」選項來清除資料檔案。 

{
 "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. 在首 顯示面板 上，按一下服務 > 安全性、身分識別、 & 法規遵循> IAM。
3. 在左側邊欄中，按一下角色。 
4. 按一下「建立角色」。 
5. 在「信任的實體類型 」部分，選取AWS 帳戶。
6. 在「AWS帳戶」區段中，選取「另一個AWS 帳戶 」，然後輸入您自己的AWS 帳戶 ID。您稍後將變更信任關係，以授予HubSpot存取權限。 
7. 選取「需要外部ID 」，然後輸入預留位置ID ，例如0000。稍後，您將變更IAM角色的信任關係，並指定儲存 整合 外部ID。外部ID用於將AWS資源的存取權授予第三方應用程式，如HubSpot。 

8. 按一下 下一步。 
9. 選取在步驟1中建立的政策，然後按一下「下一步」。
10. 在「角色詳細資訊 」區段中，輸入角色名稱  和描述 以 識別 角色。 
11. 按一下「建立角色」。 
12. 在「 角色摘要」頁面上，複製ARN 值。您將在下一個步驟中使用此值。 

4.連結 HubSpot和AWS S3

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的「Marketplace 圖示」，然後選取「HubSpot Marketplace」。
2. 搜尋並選擇 AWS S3。 
3. 按一下「 安裝」。 
4. 輸入在步驟3中配置的 IAM角色名稱，以及要儲存資料的儲存區的S3 URL路徑 。 
5. 按一下 下一步。
6. 檢查並複製 AWS IAM使用者 和AWS外部ID值，因為您在下一個步驟中將需要這些值。然後，按一下「 繼續」至「已連結的應用程式」。 

5.授予IAM使用者存取Bucket物件的權限

1. 登入 AWS管理主控臺。
2. 在首 顯示面板 上，按一下服務 > 安全性、身分識別、 & 法規遵循> 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 連絡人 人和公司區隔。
• 擁有者：記錄 擁有者。 
• 管道：交易 和 服務票證 管道以及 管道 階段。 
• 屬性：物 物件 記錄上的屬性及其值，包括 屬性 歷史記錄。 

不同類型的物件數據以兩種方式組織並可用：

• 個人：每個 物件類型 都儲存在自己的表格中，並且只有相同 物件類型 記錄。例如，只 objects_contacts 包含 連絡人 記錄。
• 合併：所有 物件 類型的ll記錄合併成一個資料庫 物件。因此，在查詢時，您需要指定一個篩選器，例如“WHERE objectTypeId = ’0-1’

自訂物件將在建立時分配一個ID ，並將被識別為2-unique_ID。例如， 2-12345。 

objects_x表

每種可用的 物件類型（包括自訂物件）都有自己的特定表格。這些表格的命名格式為， OBJECTS_<object type name> 其中 <object type name> 是的複數 表單 標籤 objecttype。請注意，如果 物件類型 沒有複數 表單，則 <object type name> 將是與「S」連接的 物件類型 名稱的單數 表單 標籤。

以下是可用的HubSpot 物件 類型的完整 清單、它們所代表的資料的簡短說明及其對應的表格。

object_with_object_properties

此表包含您的HubSpot記錄中的資料。您可以為物件類型中的每個 記錄 獲得一行（例如，連絡人 絡人記錄）。 

對象_特性_歷史

此表包含歷史 屬性 值。對於聯系人，它包含最新的45值。對於所有其他對象，它包含最近的20個值。表格中的每個歷史 屬性 值都有一行。物業的當前值由 屬性 歷史記錄中最新的UPDATEDAT時間戳記決定。

關聯 查詢

與物件資料一樣，關聯資料有兩種組織方式：

• 個人： 每個 關聯 類型都存儲在自己的表中，並且只包含該類型的記錄。例如，僅 associations_contacts_to_deals 包含客服案件與 交易 物件之間的 關聯 連絡人 記錄。T
• 合併： 所有 關聯 類型的所有記錄都合併到一個表格中。

associations_x_to_y 

每種 關聯 類型都有自己的視圖，標記為 associations_<association type name> 例如 associations_contacts_to_deals。 

association_definition

此表格包含有關HubSpot物件之間所有可用關 關聯 類型的資訊，每個關 關聯 類型一行。

特性定義

此表包含有關HubSpot 帳戶 中的物件   事件 屬性的資訊。事件 屬性包括標準事件，例如電子郵件開啟和點擊，以及自訂行為事件屬性。此信息有助於定義object_properties和events數據中的值。

事件

事件包括標準HubSpot事件和自訂行為事件。每個 事件 都有自己的表格，標記為 events_eventname。

object_and_event_type_definition

此表包含您HubSpot 帳戶 中可用的所有物件和事件的定義。

同步頻率和資料組織

數據每天 在HubSpot和AWS S3之間同步。系統會為資料同步處理的每一天建立一個資料夾。以下每個表格都將作為包含gzip 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 ，則每個表格資料夾下都會有多個gzip壓縮的CSV檔案。