ベータHubSpot を Microsoft Fabric に連携する

HubSpotをMicrosoft Fabricに連携させ、倉庫データをHubSpotに取り込んだり、HubSpot CRMの選択したデータをMicrosoft Fabricにエクスポートしたりできます。データスタジオを使用して、HubSpot のデータに加えて Microsoft Fabric のデータにアクセスしたり、データアウト同期を設定して、選択したオブジェクト、関連付け、およびイベントを Microsoft Fabric ウェアハウスのテーブルにエクスポートしたりできます。

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

始める前に

HubSpotをMicrosoft Fabricに接続する前に、以下の要件と注意事項を確認してください。

要件を理解する

Microsoft Fabric とデータを同期するには、以下のものが必要です：

• Fabric Warehouse を含む Microsoft Fabric ワークスペース。
• HubSpotからエクスポートしたデータを保存するための、ワークスペース内の「ウェアハウス」。
• Microsoft Entra ID のサービスプリンシパルが、Fabric ワークスペースに「Contributor」ロールで追加されました。
• サービスプリンシパルのテナント ID、クライアント ID、およびクライアントシークレット。

Microsoft Entra ID のサービスプリンシパルは、宛先の Fabric Warehouse 内で HubSpot が所有するオブジェクトを作成および管理する権限を持っている必要があります。接続の検証および同期の過程で、HubSpot はスキーマとテーブルを作成し、データを挿入し、ステージングテーブルの名前を変更し、一時オブジェクトを削除します。Fabric ワークスペースにおいて、サービスプリンシパルに「Contributor」ロールを付与し、HubSpot が以下の操作を行えるようにします：

• スキーマを作成する
• テーブルを作成する
• 行を挿入する
• HubSpotが所有するテーブルの名前変更または変更
• HubSpotが所有するテーブルとスキーマを削除する

Fabric WarehouseのSQLエンドポイントは、TCPポート1433経由でHubSpotからアクセス可能である必要があります。HubSpotでは、すべての接続にTLSを使用し、サーバー証明書の検証を行っています。

Fabric ワークスペースでネットワークアクセスが制限されている場合は、アカウントのリージョンに対応する HubSpot の送信元 IP アドレスを許可リストに追加してください。

制限事項と考慮事項を理解する

• Microsoft Fabric Data Out は、Fabric ウェアハウスでのみサポートされています。レイクハウスは、エクスポート先としてサポートされていません。
• 同期が行われるたびに、選択されたHubSpotデータの完全なスナップショットが作成されます。同期が正常に完了すると、宛先テーブル内の以前のスナップショットが置き換えられます。HubSpotでは、以前のスナップショットは保持されません。同期中にテーブルでエラーが発生した場合、そのテーブルの以前のデータは、次に同期が正常に完了するまで引き続き利用可能です。
• 各オブジェクト、イベント、または関連付けのペアは、HubSpotアカウントごとに1つのMicrosoft Fabric定期同期に含めることができます。
• 同期が行われるたびに、宛先テーブルの内容が上書きされます。Fabric Warehouse に追加されたテーブルレベルのグラントや設定は、同期のたびに保持されません。
• 別のサービスプリンシパルと再接続するには、接続テストや同期を成功させる前に、そのサービスプリンシパルを「Contributor」ロールでFabricワークスペースに追加する必要があります。

Microsoft Fabric アプリをインストールする

Microsoft FabricとHubSpotを連携させるには、HubSpotアカウントとMicrosoft Fabricワークスペースを、それぞれ別のブラウザタブで開くことをお勧めします。

1. HubSpotアカウントにて、上部のナビゲーションバーに表示されるマーケットプレイスアイコン をクリックし、［HubSpotマーケットプレイス］を選択します。
2. 「Microsoft Fabric」アプリを検索して選択します。
3. ［インストール］をクリックします。
4. 必要な Microsoft Entra ID 情報を入力してください：

• • テナントID
  • クライアントID
  • クライアントシークレット

5. 「Microsoft Fabric に接続」をクリックします。

HubSpotをMicrosoft Fabric Warehouseに連携する

Microsoft Fabric ワークスペースで、Microsoft Entra ID サービスプリンシパルに「Contributor」ロールが割り当てられていることを確認してください。

Microsoft Fabric アプリをインストールすると、HubSpot の「データ連携」ツールにリダイレクトされます。そこでは、サイドパネルが表示され、同期したい方向に応じて、HubSpot と Microsoft Fabric 間のデータ連携の手順が案内されます：

• Microsoft Fabric → HubSpot：Microsoft Fabric から HubSpot への同期を設定します。
• HubSpot → Microsoft Fabric：HubSpot から Microsoft Fabric への同期を設定します。