ベータAmazon Redshift から HubSpot のデータにアクセスする

「Amazon Redshift用データ出力」を使用して、選択したHubSpot CRMのデータを、ご自身が所有するAmazon Redshiftデータベース内のテーブルにエクスポートします。同期処理が実行されるたびに、選択されたデータの完全なスナップショットが書き込まれ、以前のスナップショットが上書きされます。同期が完了したら、SQL またはお好みの BI ツールやアナリティクスツールを使用してテーブルをクエリし、HubSpot のデータを他のビジネスデータと統合することができます。

注: スーパー管理者である場合は、この機能を使用するには、アカウントをデータポータルベータ版 にオプトインしてください。

制限事項と考慮事項について

この機能を使い始める前に、あらかじめ必要となる手順と、この機能の使用に伴う制限事項と潜在的な結果について十分に理解しておいてください。

• 同期が行われるたびに、宛先テーブルは最新のスナップショットで上書きされます。HubSpotは、Redshiftに過去のスナップショットを保存しません。
• HubSpotは、お客様のS3バケットに一時保存したParquetファイルを削除することはありません。これらを自動的に削除するには、バケットまたはプレフィックスに対してS3ライフサイクルポリシーを設定してください。
• 各オブジェクト、イベントタイプ、または関連付けのペアは、HubSpotアカウントごとに1つの定期的なRedshift Data Out同期に含めることができます。
• センシティブデータについては、現時点では対応していません。機密性の高いプロパティーは、エクスポートの対象から除外される場合があります。
• 次のようなオブジェクト固有のテーブルOBJECTS_CONTACTS、といったオブジェクト固有のテーブルは、現時点ではサポートされていません。

エクスポート可能なデータについて理解する

HubSpot から Amazon Redshift へ、以下のデータを同期することができます：

• オブジェクト：連絡先、企業、商談、チケット、製品など、標準およびカスタムオブジェクト。
• レコード：選択したオブジェクトごとの個別のレコード。
• プロパティー：レコードの選択されたプロパティー値およびプロパティーの履歴。
• 関連付け：レコード間の特定の関係。これには、関連付けの定義も含まれます。
• イベント：特定の標準HubSpotイベントおよびカスタム行動イベント。これには、特定のイベントプロパティーも含まれます。

各オブジェクトのデータは、オブジェクトテーブルにまとめられています。オブジェクトテーブルを読み込む際は、OBJECTTYPEIDを使用して、特定のオブジェクトに絞り込んでください。たとえば、連絡先では0-1を使用します。カスタムオブジェクトには、作成時にIDが割り当てられ、2-{unique_id}、例えば2-12345。

エクスポート形式について理解する

セットアップ中に、以下の項目を選択します：

• Redshift データベース、および HubSpot がテーブルを作成するクラスターまたはサーバーレスワークグループ。
• HubSpotが、Redshiftにデータをロードする前にデータを一時的に格納するために使用するS3バケット。
• 同期するデータソース：オブジェクト、イベント、関連付け、またはこれらの組み合わせ。
• 同期スケジュール。

HubSpotはデータをParquetファイルとしてエクスポートし、そのファイルをS3バケットに一時保存した後、Redshiftテーブルに読み込みます。

ご注意： HubSpotはステージングバケットからデータを削除することはありません。バケットを自動的にクリーンアップするように、バケットのライフサイクルポリシーを設定することをお勧めします。

Redshiftでデータを検索する

HubSpot は、データソースごとに 1 つのテーブルを作成し、そのテーブルは、宛先の名前にちなんで名付けられた 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は、S3バケット内のHubSpotが管理するプレフィックスの下にParquetファイルをステージングし、その後それらをRedshiftに読み込みます：

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

これらのステージングファイルは、削除するまでバケット内に残ります。これらを自動的に削除するには、バケットまたはプレフィックスに対してS3ライフサイクルポリシーを設定してください。

ご注意：テーブル名および列名は、エクスポートされたデータに基づいています。Redshiftの識別子長の上限である127文字に合わせるため、短縮される場合があります。列の種類は、エクスポートされたデータに準じます。

オブジェクトテーブルの確認

オブジェクトデータを選択すると、HubSpotは以下のテーブルをエクスポートします。

OBJECT_PROPERTIES

この表には、プロパティー値ごとに1行ずつ含まれています。特定のオブジェクトを読み取るには、OBJECTTYPEIDでフィルタリングします。

OBJECT_WITH_OBJECT_PROPERTIES

このテーブルにはレコードごとに1行が含まれており、選択されたプロパティーの値は1つのPROPERTIES列にまとめられています。特定のオブジェクトを読み取るには、OBJECTTYPEIDでフィルタリングします。

OBJECT_PROPERTIES_HISTORY

この表には、プロパティー変更履歴が記載されています。これとは異なりOBJECT_PROPERTIESとは異なり、このテーブルにはプロパティーの過去の値ごとに1行が格納されています。個々のレコードおよびプロパティーの一覧タイムライン全体を表示するには、UPDATEDATで並べ替えてください。

関連付けテーブルを確認

関連付けデータを選択すると、HubSpotは関連付けレコードと関連付け定義をエクスポートします。

協会

このテーブルには、2つのレコード間の選択された関連付けごとに1行が含まれています。

ASSOCIATION_DEFINITIONS

この表には、選択された関連付けの定義ごとに1行が記載されています。

ASSOCIATIONS_ <FROM_OBJECT>_TO_ <TO_OBJECT>

選択された関連付けのペアについては、HubSpotでは、次のようなペア固有の関連付けテーブルをエクスポートすることもできます。ASSOCIATIONS_CONTACTS_TO_COMPANIES。これらのテーブルには、関連付けレコードと、関連付けの定義に関するメタデータが含まれています。

イベントテーブルを確認する

イベントデータを選択すると、HubSpotはイベントタイプごとに1つのテーブルをエクスポートします。テーブル名は、EVENTS_<EVENT_NAME>の形式で指定します。例えばEVENTS_VISITED_PAGEといった形式です。

各イベントテーブルには、標準のイベント列と、選択されたイベントプロパティーごとに1つの列が含まれています。

同期スケジュールの管理

HubSpotでのセットアップ中に、同期スケジュールを設定します。HubSpotから手動で再同期のトリガーを実行することもできます。同期処理が実行されるたびに、選択されたデータの完全なスナップショットが生成されます。データ量を制御するには、含めるオブジェクト、イベント、関連付け、およびプロパティーを選択してください。

ご注意：ベータ版期間中は、同期頻度が「1回」「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';

特定のプロパティーをPROPERTIES JSON列から特定のプロパティを読み取るには：

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';

1つのデータ型を、複数のRedshift同期でエクスポートすることはできますか？

各オブジェクト、イベントタイプ、または関連付けのペアは、HubSpotアカウントごとに1つの定期的なRedshift Data Out同期に含めることができます。たとえば、連絡先がすでに1つの定期的なRedshift送信先にエクスポートされている場合、最初の同期をアーカイブするまでは、別の定期的なRedshift同期に連絡先を追加することはできません。

オブジェクト固有のテーブルはサポートされていますか？

いいえ。OBJECTS_CONTACTSのようなオブジェクト固有のテーブルは、現時点ではサポートされていません。「OBJECT_WITH_OBJECT_PROPERTIESを使用し、OBJECTTYPEIDでフィルタリングして、特定のオブジェクトのレコードを取得します。

センシティブデータは対応していますか？

いいえ。現時点では、Redshiftへのデータ出力においてセンシティブデータはサポートされていません。機密性の高いプロパティーは、エクスポートの対象から除外される場合があります。

HubSpotは以前のスナップショットを保存していますか？

いいえ。同期を行うたびに、宛先テーブルは最新のスナップショットで上書きされるため、以前のスナップショットはRedshiftには保持されません。また、HubSpotは、S3バケットに一時的に保存したParquetファイルも削除しません。S3のライフサイクルポリシーを設定して、それらを自動的に期限切れにするようにします。