測試版將 HubSpot 資料匯出至 Amazon Redshift

摘要

透過 HubSpot Marketplace 中的 Amazon Redshift 應用程式，將 HubSpot CRM 物件、關聯及事件匯出至 Amazon Redshift。您可以在 HubSpot 中選擇要匯出的資料、設定同步排程，並監控同步活動。

本文將說明如何安裝並連線至該應用程式、設定資料匯出同步，以及監控或管理同步作業。

請注意： 如果您是 超級管理員，您可以將您的帳戶加入「改良版 Amazon Redshift 整合」測試版。

開始之前

了解需求

請確保您具備以下條件：

• 一個已連結至您的 HubSpot 帳戶，並已設定可存取您的 AWS 帳戶之 AWS 身分與存取管理 (IAM) 角色。
• 一個 HubSpot 可存取的 Amazon Redshift 預配置叢集或無伺服器工作群組。
• 一個用於暫存 Parquet 檔案的 Amazon S3 儲存桶。該儲存桶必須位於與您的 Redshift 叢集或無伺服器工作群組相同的 AWS 區域中。
• HubSpot 會將臨時 Parquet 檔案複製到已設定的 Amazon S3 中繼儲存桶中，且不會刪除這些檔案。若要移除較舊的檔案並管理儲存成本，請在您的 AWS 帳戶中建立 S3 生命週期規則。
• 一位 Redshift 管理員，能夠在目標資料庫上執行一次性的 SQL 授權操作。
• 需具備 HubSpot 與 AWS 控制台的存取權限。建議分別在不同的分頁中開啟。

了解限制與注意事項

• 每次同步都會產生所選資料的完整快照。
• 每次同步都會覆寫目標資料表。在 Redshift 中新增的任何資料表層級授權或設定，在同步之間均不會被保留。
• 您可以透過選擇要包含的物件、關聯及事件，來控制匯出的資料量。
• 若同步失敗，下一次排定的同步將自動再次嘗試執行完整同步。

安裝並連線至 Amazon Redshift 應用程式

1. 在HubSpot 應用程式市集（App Marketplace）中，開啟 Amazon Redshift 應用程式的頁面。
2. 選擇與您的 HubSpot 帳戶連結的 AWS 角色。
3. 點擊「安裝」。
4. 點擊「下一步」。
5. 建立一個與您的 HubSpot 帳戶連結，並已設定可存取您的 AWS 帳戶的 AWS IAM 角色。
6. 輸入該角色的 Amazon 資源名稱 (ARN)。
7. 點擊「連線至 Amazon Redshift」。

設定您的 AWS 角色

HubSpot 會使用已連線的 AWS 角色，將臨時 Parquet 檔案寫入您的 S3 中繼儲存桶，並將檔案載入 Redshift。

1. 在「S3 儲存桶 URL」欄位中，輸入 HubSpot 將用於暫存臨時 Parquet 檔案的 S3 儲存桶 URL。

您可以在 URL 中加入前綴，以限制對儲存桶內特定路徑的存取。該儲存桶必須位於與您的 Redshift 叢集或無伺服器工作群組相同的 AWS 區域中。

請注意：根據設計，HubSpot 會將 Parquet 檔案複製到已設定的 S3 中繼儲存桶中，且不會刪除這些檔案。請在 AWS 中建立 S3 生命週期規則，以自動移除較舊的檔案。

2. 從下拉式選單中選擇您的 Redshift 部署類型：
   • Redshift 無伺服器
   • 預配置叢集
3. 根據您的部署類型，更新已連線的 AWS 角色以套用權限政策：
   • Redshift 無伺服器模式：輸入您的工作群組 ARN。HubSpot 將生成一份包含該 ARN 的權限政策。請複製該政策，並將其附加至已連線的 AWS 角色。
   • 預配置叢集：複製政策範本。將YOUR_REGION 、YOUR_ACCOUNT_ID 、YOUR_CLUSTER_ID 及YOUR_DATABASE 替換為您 AWS 帳戶中的實際值，然後將該政策附加至已連線的 AWS 角色。
4. 在 AWS IAM 中，開啟與 HubSpot 連結的角色。
5. 將生成的權限政策附加至該角色，或根據該政策內容建立內嵌政策。

6. 在同一個 AWS IAM 角色中，使用 HubSpot 生成的陳述式來更新信任政策。

HubSpot 會根據您所選的 Redshift 部署類型，產生不同的信任政策陳述式。

將 AWS 角色與 Redshift 關聯

在 Amazon Redshift 中，將您在上節中更新的同一 AWS 角色與您的 Redshift 設定關聯。

• Redshift Serverless：開啟您與 HubSpot 搭配使用的命名空間之命名空間設定頁面。在「安全性與加密」索引標籤中，按一下「管理 IAM 角色」，然後選取「關聯 IAM 角色」。
• 預配置叢集：開啟您的叢集，點擊「動作」，然後選擇「管理 IAM 角色」>「關聯 IAM 角色」。

授予 Redshift 權限

1. 在 HubSpot 中，選取目標資料庫。
2. 請 Redshift 管理員在所選資料庫中執行 SQL 指令碼。

HubSpot 會利用此權限在同步過程中為目標資料庫建立資料結構。

3. 點擊「測試連線」。
4. 若連線測試成功，請點選「下一步」。

設定資料匯出同步

1. 選取要匯出的資料來源。
2. 選取要包含的物件、關聯及事件資料表。
3. 設定同步頻率與開始時間。
4. 點擊「開始同步」。

每次同步執行都會將所選資料的完整快照匯出至 Amazon Redshift。

監控與管理同步

在同步詳細資訊頁面上，您可以檢視以下資訊：

• 同步狀態。
• 上次同步時間。
• 錯誤。
• 同步活動。
• 同步歷史紀錄。

要開啟同步詳細資訊頁面：

1. 在您的 HubSpot 帳戶中，導航至「資料管理」>「資料整合」。
2. 在「應用程式同步」分頁中，搜尋 Amazon Redshift 應用程式同步項目。
3. 點選您要檢視的 Amazon Redshift 同步項目。

在同步詳細資訊頁面上，您還可執行以下操作：

• 點擊「暫停」以暫停同步。
• 點擊「歸檔」以將同步作業歸檔。
• 點擊「立即同步」以手動啟動同步。

同步狀態

解決同步失敗問題

當同步失敗時：

• 同步在 HubSpot 中會顯示「失敗」狀態。
• 各資料表的詳細資訊會顯示哪些資料表成功或失敗。
• 下次排定的同步將自動再次嘗試執行完整同步。
• 您可以點擊「立即同步」以手動啟動另一項同步作業。