ベータMicrosoft Azure アナリティクスから HubSpot データにアクセスする

「Azure Synapse 向け Data Out」を使用して、選択した HubSpot CRM データを、ご自身が所有する Azure Synapse の専用 SQL プール内のテーブルにエクスポートします。HubSpotは、選択したデータの完全なエクスポートデータに基づいて、各出力テーブルを更新します。同期が完了したら、SQL またはお好みの BI ツールやアナリティクスツールを使用してテーブルをクエリし、HubSpot のデータを他のビジネスデータと統合することができます。

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

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

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

• HubSpotでは、テーブルは個別に更新されます。同期の実行中に複数のテーブルに対してクエリを実行すると、一部のテーブルは他のテーブルよりも先に更新される場合があります。
• Data Out では、過去のスナップショットの保持機能は提供されていません。更新が正常に完了すると、宛先テーブルには最新のスナップショットが格納されます。
• 各オブジェクト、イベントタイプ、または関連付けのペアは、HubSpot アカウントごとに 1 つの定期的な Azure Synapse 同期に含めることができます。この制限は、他のData Outプロバイダーとは無関係です。
• 次のようなオブジェクト固有のテーブルOBJECTS_CONTACTS、といったオブジェクト固有のテーブルは、現時点ではサポートされていません。
• HubSpot による正規化後に 2 つのテーブル名が重複する場合、影響を受けるエクスポートは失敗します。詳細については、テーブル名および列名の規則をご確認ください。

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

HubSpot から Azure Synapse アナリティクス へ、以下のデータを同期できます：

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

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

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

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

• 宛先の Azure Synapse 専用 SQL エンドポイントおよびデータベース。
• 同期するデータソース：オブジェクト、イベント、関連付け、またはこれらの組み合わせ。
• 同期スケジュール。

HubSpotは、HubSpotが管理するストレージに一時的なParquetエクスポートを作成し、その結果をAzure Synapseの専用SQLプール内のテーブルに書き込みます。ステージング用バケットを用意したり管理したりする必要はありません。

Azure Synapse でデータを探す

HubSpotは、宛先に対して、HubSpotが管理するスキーマに基づいて出力テーブルを作成します。HubSpotは、この記事で説明している3つのオブジェクトテーブルにオブジェクトデータをエクスポートします。また、HubSpot は、選択されたイベントタイプごとに 1 つのテーブルを作成し、利用可能な場合は、選択された関連付けのペアごとに 1 つのペア固有のテーブルを作成します。

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

正確なスキーマ名は、同期の設定ページで確認できます。例えば、次のような使い方が考えられます。

• 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では、エクスポートされたテーブル名および列名を、大文字、数字、およびアンダースコアに正規化します：

• スペースとハイフンはアンダースコアに置き換えられます。
• その他の英数字以外の文字は削除されます。
• 128文字を超える名前は短縮されます。
• 重複する列名には接尾辞が付与されます。
• テーブル名の重複があると、該当するエクスポートが失敗します。

識別子をクエリで参照する際は、特に動的にクエリを構築する場合は、角括弧を使用してください。識別子の大文字小文字の区別は、Synapse データベースの照合順序によって異なります。例えば、次のような使い方が考えられます。

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

列のタイプ

列の型はエクスポートされたデータに準拠しており、Azure Synapse の型には次のように対応付けられます：

ご注意：PROPERTIESの列はOBJECT_WITH_OBJECT_PROPERTIESの列は、JSON形式の文字列としてエクスポートされます。これはNVARCHAR(MAX)として保存されており、JSON列型としては保存されていません。クエリの例については、FAQをご覧ください。

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

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

ご注意：ベータ版期間中は、利用可能な同期の頻度が制限される場合があります。今後のリリースで、さらに周波数オプションが追加される可能性があります。

同期の監視とエラー処理

HubSpot で Azure Synapse の同期状況を監視できます。同期には、以下のいずれかの状態があります：

同期に失敗した場合：

• HubSpot では「失敗」というステータスが表示され、どのテーブルが成功し、どのテーブルが失敗したかについての詳細が表示されます。
• テーブルを更新できない場合でも、通常、以前に正常に更新されたデータは引き続き利用可能です。
• 定期的な同期の場合、次回の予定された同期で自動的にフル同期が再試行されます。
• HubSpotでは、いつでも手動で再同期のトリガーを実行できます。

よくある質問

データの照会方法は？

SQL を使用して、宛先スキーマ内のテーブルをクエリします。たとえば、すべてのコンタクトレコードを読み込むには：

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

特定のプロパティーをPROPERTIES JSON文字列から特定のプロパティを読み取る:

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

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

各オブジェクト、イベントタイプ、または関連付けのペアは、HubSpot アカウントごとに 1 つの定期的な Azure Synapse 同期に含めることができます。この制限は、他のData Outプロバイダーとは無関係です。

たとえば、連絡先がすでに定期的な Azure Synapse 宛先にエクスポートされている場合、最初の同期をアーカイブするまでは、別の定期的な Azure Synapse 同期に連絡先を追加することはできません。その際も、対応している別のData Outプロバイダーへ連絡先をエクスポートすることは可能です。

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

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

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

いいえ。「Data Out」では、過去のスナップショットの保持機能は提供されていません。更新が正常に完了すると、宛先テーブルには最新のスナップショットが格納されます。テーブルを更新できない場合でも、通常、以前に正常に更新されたデータは引き続き利用可能です。