メインコンテンツまでスキップ
に最終更新

HubSpotコネクタのトラブルシューティング

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。「Databricks プレビューの管理」を参照してください。

LakeFlow Connectの管理対象 HubSpot コネクタに関する一般的な問題のトラブルシューティング方法について説明します。

接続の作成中またはパイプラインの実行中にスコープエラーが発生しました​

エラーメッセージ:

SCOPE Error

原因：

このエラーは、HubSpot アプリに必要な OAuth スコープがない場合に発生します。

ソリューション:

HubSpot の接続アプリに必要な OAuth スコープがあることを確認します。

  1. https://app-na2.hubspot.com/legacy-apps/<hubspot-id> HubSpot アプリ構成ページにアクセスしてください。
  2. アプリの 認証 設定に移動します。
  3. [スコープ] > [必要なスコープ] で、必要なすべてのスコープが選択されていることを確認します。必要なスコープの完全なリストについては、 「HubSpot 取り込み用の OAuth の構成」を参照してください。
  4. 変更を保存し、 Databricksに新しいUnity Catalog接続を作成します。

アプリ構成の詳細については、 「HubSpot 取り込み用の OAuth を構成する」を参照してください。

接続作成の詳細については、 HubSpotを参照してください。

パイプラインの実行速度が遅い​

症状：

パイプラインの完了に長い時間がかかるか、パイプラインが停止しているように見えます。

原因：

HubSpot では、リクエストあたり 10 秒の制限を含む API レート制限が適用されます。複数のテーブルを同時に取り込むと、これらのレート制限に達し、取り込みプロセスが遅くなる可能性があります。

さらに、一部のテーブルでは、API 呼び出しの要件が高いために、取り込みに長い時間がかかることがあります。たとえば、 marketing_campaign_assetテーブルでは、キャンペーンごとに 24 回の個別の API 呼び出しが必要です。キャンペーンが 100 個ある場合、この 1 つのテーブルに対して約 2,400 回の API 呼び出しが必要になりますが、よりシンプルなテーブルの場合は約 5 回の API 呼び出しで済みます。これらのテーブルでは同期に長い時間がかかることが予想されます。たとえば、5,000 件のキャンペーンを含むテーブルの場合は、およそ 4 ～ 6 時間かかります。

適用可能なテーブルの完全なリストについては、 「バッチ更新のみをサポートするテーブル」を参照してください。

ソリューション:

一貫した取り込みパフォーマンスを確保するには:

  • 同時に取り込むテーブルの数を制限します。
  • テーブルを複数のパイプラインに分割し、異なる時間にスケジュールします。
  • パイプラインの進行状況を監視し、実際の同期時間に基づいてスケジュール戦略を調整します。