上次更新時間： 2026年7月22日
連接 HubSpot 與 AWS S3
- 在你的 HubSpot 帳戶中，點擊頂端導覽列中的「Marketplace 圖示」
，然後選取「HubSpot Marketplace」。 - 在搜尋欄中，搜尋並選取Amazon S3。
- 點擊「安裝」。
- 選擇您的AWS IAM角色，然後點選「安裝」。
- 點擊「下一步」。
- 在「角色 ARN」欄位中，輸入來自 AWS IAM 角色的ARN 值。
- 點擊「連線至 Amazon S3」。
設定儲存桶權限
HubSpot 需要對 AWS S3 儲存桶及其資料夾擁有以下權限，才能存取該資料夾及其子資料夾中的檔案：
- s3:GetBucketLocation
- s3:GetObject
- s3:GetObjectVersion
- s3:ListBucket
- s3:上傳物件
- s3:刪除物件
連接應用程式後，請授予 HubSpot 將資料同步至您的 S3 儲存桶的權限。
- 在你的 HubSpot 帳戶中，點擊頂端導覽列中的
「設定圖示」。在左側邊欄選單中，前往「整合功能」>「已連結的應用程式」。 - 點擊「Amazon S3」。
- 在右側面板中，點選您要同步資料至的 Amazon S3 帳戶旁的「選取」。
- 在「權限」頁面上，點擊「複製」以複製範例權限政策，並將其附加至您先前建立的 AWS IAM 角色。請注意，需將權限政策中的儲存桶名稱更新為您的實際名稱。
- 登入AWS 管理主控台。
- 在首頁儀表板上，點選「服務」>「安全性、身分識別與合規性」> 「IAM」。
- 在左側邊欄中，點擊「帳戶設定」。
- 在「安全憑證服務(STS)」區段中，尋找與您的 AWS 帳戶所在區域對應的 AWS 區域。點擊以開啟開關，以啟用該區域。
- 在左側面板中，點選「政策」。
- 點選「建立政策」。
- 在「JSON」分頁中，點選「新增陳述式」。
- 新增您在步驟 4 中複製的政策，該政策將授予 HubSpot 所需的權限，使其能透過單一儲存桶和資料夾路徑載入或匯出資料。
- 請務必將<bucket>和<prefix>替換為您的實際儲存桶名稱和資料夾路徑前綴。政府區域中儲存桶的 Amazon 資源名稱 (ARN) 具有 arn:aws-us-gov:s3::: 這個前綴。
- 將 s3:prefix 條件設定為 ["*"] 或 ["<路徑> /*"]，將分別授予對指定儲存桶內所有前綴，或該儲存桶內指定路徑的所有前綴的存取權限。
- 點擊「下一步」。
- 在「檢視與建立」區段中，輸入「政策名稱」及（若需）說明文字。
- 點擊「建立政策」。
設定目標儲存桶
- 返回 HubSpot 的「權限」頁面，在「儲存桶」欄位中輸入儲存桶名稱。
- 點擊「測試連線」。
- 若連線測試成功，請點擊「下一步」。
設定同步
- 在「資料來源」頁面中，選取您要同步的資料。
- 勾選您要從 HubSpot 同步至 Amazon S3 的物件、關聯及事件的核取方塊。
- 點擊「下一步」。
- 在「詳細資訊」頁面上，點選「同步頻率 」下拉式選 單，並選擇您希望從 HubSpot 同步至 Amazon S3 的資料頻率。
- 點擊「開始同步」。
管理同步
設定同步後，當資料開始從 HubSpot 同步至 Amazon S3 時，您可以檢視其狀態、識別錯誤、更新設定，或將同步作業歸檔。
若要檢視及管理同步作業：
- 在你的 HubSpot 帳戶中，點擊「更多」，然後前往「資料管理」 > 「資料整合」。如果你的帳戶中沒有顯示「更多」，請直接前往「資料管理」 > 「資料整合」。
- 導航至「應用程式同步」分頁，並在表格中找到您的 Amazon S3 同步項目。
- 檢視同步狀態：
-
- 同步中：同步作業正在進行中。
- 已同步：上次同步已成功完成。
- 失敗：上次同步發生錯誤。
- 已歸檔：同步設定已被移除。
- 點擊同步名稱以查看更多詳細資訊，包括已成功同步及失敗的記錄。
若要編輯或移除同步作業：
- 在表格中，點擊該Amazon S3同步項目。
- 在右上角，點擊「動作」下拉式選單，然後選擇以下其中一項：
-
- 編輯同步：更新同步設定。
- 歸檔同步：刪除同步設定。
HubSpot 與 Amazon S3 之間的同步資料格式
可同步的資料
您可以將以下資料從 HubSpot 同步至 AWS S3：
- 物件：標準及自訂物件，例如聯絡人、公司、票證或產品。
- 記錄：個別物件記錄。
- 屬性：物件記錄上的屬性及其值，包括屬性歷史紀錄。
- 關聯：所有關聯類型及相關聯的記錄。
- 事件：選定的標準 HubSpot 事件和自訂行為事件，包括選定的事件屬性。
不同類型的物件資料會以兩種方式進行組織與提供：
- 獨立：每種物件類型皆儲存於各自的資料表中，且僅包含相同物件類型的記錄。例如
objects_contacts僅包含聯絡人記錄。 - 合併：所有物件類型的記錄均合併至單一資料庫物件中。因此，在查詢時，您需要指定類似「WHERE objectTypeId=’0-1’」的篩選條件
自訂物件在建立時會被指派一個 ID，並以「2-unique_ID」的形式標示。例如：2-12345。
S3 資料夾結構
HubSpot 會將每次成功的同步資料寫入您 Amazon S3 儲存桶中由 HubSpot 管理的預設前綴，並採用以下結構：
s3://<bucket-name>/hubspot-dataout/<account-id>/<run-id>/<table-name>/<file-name>
例如：
s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/OBJECT_WITH_OBJECT_PROPERTIES/part-000.parquet
s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/EVENTS_VISITED_PAGE/part-000.parquet
s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/ASSOCIATIONS_CONTACTS_TO_COMPANIES/part-000.parquet
每次同步都會建立一個新的 run-id資料夾。HubSpot 不會刪除先前同步執行所產生的資料。
若要自動移除較舊的同步資料，請針對儲存桶或前綴設定 Amazon S3 生命週期政策。
HubSpot 會為每次同步執行產生專屬的檔案名稱，且不同同步執行之間的檔案名稱可能有所不同。請勿將下游流程設定為依賴特定的檔案名稱。相反地，請讀取您要處理的匯出執行中，對應於該執行之table-name資料夾內的所有檔案。
物件檔案
若您選取物件資料，HubSpot 會匯出以下資料夾：
OBJECTS_PROPERTIES
每個物件屬性值佔一行。
| 欄位名稱 |
類型 |
描述 |
|---|---|---|
| OBJECTTYPEID |
字串 |
物件類型的識別碼。例如，聯絡人使用 0-1。 |
| OBJECTID |
數字 |
記錄的 ID。 |
| NAME |
字串 |
屬性名稱。 |
| VALUE |
字串 |
屬性值。 |
| UPDATEDAT |
時間戳記 |
該屬性值在 HubSpot 中最後一次更新的日期與時間。 |
| INGESTEDAT |
時間戳記 |
資料最後一次匯入至匯出來源的日期與時間。 |
OBJECT_WITH_OBJECT_PROPERTIES
每筆物件記錄佔一行，其中選定的屬性值會彙整至單一的「PROPERTIES」欄位中。
| 欄位名稱 |
類型 |
描述 |
|---|---|---|
| OBJECTTYPEID |
字串 |
物件類型的識別碼。例如，聯絡人使用 0-1。 |
| OBJECTID |
數字 |
記錄的 ID。 |
| PROPERTIES |
物件或 JSON |
該記錄所選取的屬性值。 |
| 更新日期 |
時間戳記 |
該記錄所選屬性在 HubSpot 中最後一次更新的日期與時間。 |
| INGESTEDAT |
時間戳記 |
資料最後一次匯入至匯出來源的日期與時間。 |
若要從此資料夾讀取特定物件類型，請以OBJECTTYPEID 進行篩選。
關聯檔案
若您選取關聯資料，HubSpot 會同步關聯記錄與關聯定義。
ASSOCIATIONS
每兩個物件記錄之間的每個選取關聯，佔一行。
| 欄位名稱 |
類型 |
描述 |
|||
|---|---|---|---|---|---|
| COMBINEDASSOCIATIONTYPEID |
字串 |
關聯定義的唯一識別碼。 |
|||
| 關聯類別 |
字串 |
關聯類型的來源。可能的值包括 `HUBSPOT_DEFINED`、`USER_DEFINED` 或 `INTEGRATOR_DEFINED`。 |
|||
| 關聯類型 ID |
數字 |
該關聯定義在其類別內的識別碼。 |
|||
| 來源物件 ID |
數字 |
來源物件記錄的 ID。 |
|||
| TOOBJECTID |
數字 |
目標物件記錄的 ID。 |
|||
| INGESTEDAT |
時間戳記 |
資料最後一次匯入至匯出來源的日期與時間。 |
|||
ASSOCIATION_DEFINITIONS
每項選取的關聯定義佔一行。
| 欄位名稱 |
類型 |
描述 |
|---|---|---|
| COMBINEDASSOCIATIONTYPEID |
字串 |
關聯定義的唯一識別碼。 |
| 類別 |
字串 |
關聯類型的來源。可能的值包括 `HUBSPOT_DEFINED`、`USER_DEFINED` 或 `INTEGRATOR_DEFINED`。 |
| ID |
數字 |
該關聯定義在其類別中的識別碼。 |
| 來源物件類型 ID |
字串 |
來源物件類型的識別碼。 |
| TOOBJECTTYPEID |
字串 |
目標物件類型的 ID。 |
| NAME |
字串 |
關聯定義的名稱。 |
| 標籤 |
字串 |
關聯定義的標籤。 |
| INGESTEDAT |
時間戳記 |
資料最後一次匯入匯出來源的日期與時間。 |
| ISMAINASSOCIATIONDEFINITION |
布林值 |
HubSpot 是否將此關聯定義顯示為相關記錄上的主要關聯。 |
ASSOCIATIONS_<來源物件類型>_TO_<目標物件類型>
針對選定的關聯對，HubSpot 也會同步特定關聯對的資料夾，例如ASSOCIATIONS_CONTACTS_TO_COMPANIES。這些資料夾包含關聯記錄以及相關的定義元資料。
| 欄位名稱 |
類型 |
說明 |
|---|---|---|
| COMBINEDASSOCIATIONTYPEID |
字串 |
關聯定義的唯一識別碼。 |
| 關聯類別 |
字串 |
關聯類型的來源。可能的值包括 HUBSPOT_DEFINED、USER_DEFINED 或 INTEGRATOR_DEFINED。 |
| 關聯類型 ID |
數字 |
該關聯定義在其類別內的識別碼。 |
| [FROMOBJECTTYPE]_OBJECTID |
數字 |
來源物件記錄的 ID。例如：CONTACT_OBJECTID。 |
| [TOOBJECTTYPE]_OBJECTID |
數字 |
目標物件記錄的 ID。例如，COMPANY_OBJECTID。 |
| INGESTEDAT |
時間戳記 |
資料最後一次匯入至匯出來源的日期與時間。 |
| TOOBJECTTYPEID |
字串 |
目標物件類型的 ID。 |
| FROMOBJECTTYPEID |
字串 |
來源物件類型的 ID。 |
| NAME |
字串 |
關聯定義的名稱。 |
| LABEL |
字串 |
關聯定義的標籤。 |
| ISMAINASSOCIATIONDEFINITION |
布林值 |
HubSpot 是否將此關聯定義顯示為相關記錄上的主要關聯。 |
事件檔案
若您選取事件資料，HubSpot 會針對每種事件類型匯出一個資料夾。資料夾名稱採用EVENTS_<EVENT_NAME> 的格式，例如EVENTS_VISITED_PAGE。
每個事件資料夾包含標準事件欄位，以及在設定過程中選取的每個事件屬性對應的欄位。
| 欄位名稱 |
類型 |
說明 |
|---|---|---|
| EVENTTYPEID |
字串 |
事件類型的 ID。 |
| ID |
字串 |
唯一的事件 ID。 |
| OBJECTTYPEID |
字串 |
與該事件相關聯的物件類型的 ID。 |
| OBJECTID |
數字 |
與該事件相關聯的物件記錄的 ID。 |
| INGESTEDAT |
時間戳記 |
事件被匯入至匯出來源的日期與時間。 |
| OCCURREDATDATEINT |
數字 |
事件日期，以 YYYYMMDD 格式的整數表示。 |
| OCCURREDAT |
時間戳記 |
事件發生的日期與時間。 |
| PROPERTY_<PROPERTY_NAME> |
字串 |
選定的事件屬性。例如，名為 page_title 的屬性會以 PROPERTY_PAGE_TITLE 的形式匯出。 |
.svg?height=99&width=353)