測試版從 Amazon Redshift 存取您的 HubSpot 資料

使用「Amazon Redshift 資料匯出」功能，將選定的 HubSpot CRM 資料匯出至您所擁有的 Amazon Redshift 資料庫中的資料表。每次同步執行時，系統會寫入選定資料的完整快照，並覆寫先前的快照。同步完成後，您可以透過 SQL 或您偏好的 BI 及分析工具查詢這些資料表，將 HubSpot 資料與其他業務資料結合。

請注意：若您是超級管理員，請將您的帳戶加入Data Studio 測試版，才能使用此功能。

了解限制與注意事項

在開始使用此功能之前，請務必充分了解事前應採取的步驟，以及該功能的限制與使用時可能產生的後果。

• 每次同步都會以最新的快照取代目標資料表。HubSpot 不會在 Redshift 中保留之前的快照。
• HubSpot 不會刪除暫存於您的 S3 儲存桶中的 Parquet 檔案。若要自動移除這些檔案，請在儲存桶或前綴上設定 S3 生命週期政策。
• 每個 HubSpot 帳戶可將每個物件、事件類型或關聯對包含於一次定期的 Redshift Data Out 同步中。
• 目前尚不支援敏感資料。可將敏感屬性從匯出內容中排除。
• 目前尚不支援物件專用資料表，例如OBJECTS_CONTACTS。

了解可匯出的資料

您可以將以下資料從 HubSpot 同步至 Amazon Redshift：

• 物件：標準與自訂物件，例如聯絡人、公司、交易、服務單和產品。
• 記錄：所選物件的個別記錄。
• 屬性：記錄中的選取屬性值及屬性歷史紀錄。
• 關聯：記錄之間的選定關聯關係，包括關聯定義。
• 事件：選定的標準 HubSpot 事件和自訂行為事件，包括選定的事件屬性。

不同物件的資料會整合在物件資料表中。當您讀取物件資料表時，請使用OBJECTTYPEID來篩選特定物件。例如，聯絡人的 ID 為0-1。自訂物件在建立時會被指派一個 ID，並以2-{unique_id} 的形式標示，例如2-12345。

了解匯出格式

在設定過程中，您需選擇：

• Redshift 資料庫，以及 HubSpot 將在其中建立資料表的叢集或無伺服器工作群組。
• HubSpot 在將資料載入 Redshift 之前，用來暫存資料的 S3 儲存桶。
• 要同步的資料來源：物件、事件、關聯，或這些來源的組合。
• 同步排程。

HubSpot 會將資料匯出為 Parquet 檔案，將檔案暫存於您的 S3 儲存桶中，並將其載入 Redshift 資料表。

請注意：HubSpot 不會從暫存桶中刪除資料。建議設定桶生命週期政策，以自動清理該桶。

在 Redshift 中查找您的資料

HubSpot 會針對每個資料來源，在由 HubSpot 管理的資料結構中建立一個以您的目標名稱命名的資料表：

<database>.hubspot_data_out_<destination-id>.<table-name>

您可以在 Redshift 同步的設定頁面上找到此模式名稱。例如：

• your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• your_database.hubspot_data_out_456.EVENTS_VISITED_PAGE
• your_database.hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

每次同步都會將資料表替換為最新的快照。若資料表在同步過程中發生錯誤，其先前資料將保留原位，直至下次同步成功為止。

HubSpot 會將 Parquet 檔案暫存於您的 S3 儲存桶中，並置於 HubSpot 管理的預置詞下，隨後將其載入 Redshift：

s3://<bucket>/<prefix>/hubspot-dataout/<portal-id>/<destination-id>/<run-id>/<table-name>/

這些暫存檔案會保留在您的儲存桶中，直到您將其移除為止。若要自動移除這些檔案，請在儲存桶或前綴上設定 S3 生命週期政策。

請注意：資料表名稱與欄位名稱取自匯出資料。為符合 Redshift 的 127 個字元識別碼限制，這些名稱可能會被縮短。欄位類型則遵循匯出資料的設定。

檢視物件資料表

若您選取物件資料，HubSpot 將匯出以下表格。

OBJECT_PROPERTIES

此資料表中，每個屬性值對應一行。若要讀取特定物件，請依OBJECTTYPEID 進行篩選。

OBJECT_WITH_OBJECT_PROPERTIES

此資料表每筆記錄對應一行，其中選定的屬性值會彙整至單一的PROPERTIES欄位中。若要讀取特定物件，請依OBJECTTYPEID 進行篩選。

OBJECT_PROPERTIES_HISTORY

此資料表包含屬性變更歷史紀錄。與僅儲存當前值的OBJECT_PROPERTIES 不同，此資料表針對每個屬性的歷史值各有一筆記錄。若要檢視單一記錄與屬性的完整時間軸，請依UPDATEDAT 排序。

檢視關聯表

若您選取關聯資料，HubSpot 會匯出關聯記錄及關聯定義。

ASSOCIATIONS

此資料表針對兩個記錄之間每項已選取的關聯，各佔一行。

ASSOCIATION_DEFINITIONS

此表格針對每個選取的關聯定義各包含一行。

ASSOCIATIONS_<來源物件>_TO_<目標物件>

針對選定的關聯對，HubSpot 亦可匯出特定於該對的關聯資料表，例如ASSOCIATIONS_CONTACTS_TO_COMPANIES。這些資料表包含關聯記錄以及關聯定義的元資料。

檢視事件資料表

若您選取事件資料，HubSpot 會針對每種事件類型匯出一個資料表。資料表名稱採用EVENTS_<EVENT_NAME> 的格式，例如EVENTS_VISITED_PAGE。

每個事件資料表包含標準事件欄位，以及針對每個已選取事件屬性各設有一欄。

管理同步排程

您可在 HubSpot 的設定過程中配置同步排程。您亦可從 HubSpot 手動觸發重新同步。每次同步執行都會產生所選資料的完整快照。為控制資料量，請選擇要包含的物件、事件、關聯及屬性。

請注意：在測試版期間，可能僅提供有限的同步頻率選項，例如「一次」、「每 6 小時」、「每 12 小時」、「每日」、「每週」及「每月」。未來版本可能會新增其他頻率選項。

監控同步狀況並處理錯誤

您可以在 HubSpot 中監控 Amazon Redshift 的同步作業。同步作業可能處於以下任一狀態：

當同步失敗時：

• HubSpot 顯示「失敗」狀態，並提供各資料表的詳細資訊，說明哪些資料表成功或失敗。
• 只有在 HubSpot 完成載入該資料表的所有資料後，該資料表才會被更新，因此您永遠不會看到部分載入的資料表。
• 若某個表格同步失敗，其先前資料將保留原狀，直至下次同步成功為止。
• 下次排定的同步會自動重新嘗試進行完整同步。
• 您可隨時在 HubSpot 中手動觸發重新同步。

若先前執行成功，則後續執行失敗時，該資料表不會被修改。

常見問題

如何查詢資料？

請使用 SQL 查詢目標資料結構中的資料表。例如：

讀取所有聯絡人記錄：

SELECT * FROM your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES WHERE OBJECTTYPEID = '0-1';

從PROPERTIESJSON 欄位讀取特定屬性：

SELECT OBJECTID, JSON_EXTRACT_PATH_TEXT(PROPERTIES, 'email') AS email FROM your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES WHERE OBJECTTYPEID = '0-1';

我可以在多個 Redshift 同步任務中匯出同一种資料類型嗎？

每個物件、事件類型或關聯對，在每個 HubSpot 帳戶中僅能包含於一個定期的 Redshift 資料輸出同步中。例如，若聯絡人已匯出至一個定期的 Redshift 目標，您必須先將第一個同步歸檔，才能將聯絡人新增至另一個定期的 Redshift 同步中。

是否支援特定物件的資料表？

不支援。目前尚不支援物件專屬表格（例如OBJECTS_CONTACTS）。請使用OBJECT_WITH_OBJECT_PROPERTIES並透過OBJECTTYPEID進行篩選，以取得特定物件的記錄。

是否支援敏感資料？

不支援。目前「資料輸出至 Redshift」功能尚不支援敏感資料。您可將敏感屬性從匯出內容中排除。

HubSpot 會保留之前的快照嗎？

不。每次同步都會以最新的快照取代目標資料表，因此 Redshift 中不會保留先前快照。此外，HubSpot 也不會刪除暫存於您的 S3 儲存桶中的臨時 Parquet 檔案。請設定 S3 生命週期政策，使其自動過期。