HubSpotコネクタのトラブルシューティング
LakeFlow Connectの管理対象 HubSpot コネクタに関する一般的な問題のトラブルシューティング方法について説明します。
接続の作成中またはパイプラインの実行中にスコープエラーが発生しました
エラーメッセージ:
SCOPE Error
原因：
このエラーは、HubSpot アプリに必要な OAuth スコープがない場合に発生します。
ソリューション:
HubSpot の接続アプリに必要な OAuth スコープがあることを確認します。
hs project openを実行して、HubSpotでアプリを開きます。- **プロジェクトコンポーネント**でアプリを選択し、次に**Auth** tabをクリックします。
- 必要なすべてのスコープが選択されていることを確認します。必要なスコープの完全なリストについては、HubSpotインジェストのOAuth構成を参照してください。
- スコープを変更する場合は、
hs project uploadを使用してアプリを再デプロイし、その後、Databricks で新しい Unity Catalog 接続を作成してください。
アプリ構成の詳細については、 「HubSpot 取り込み用の OAuth を構成する」を参照してください。
接続の作成の詳細については、HubSpot接続の作成を参照してください。
パイプラインの実行速度が遅い
症状：
パイプラインの完了に長い時間がかかるか、パイプラインが停止しているように見えます。
原因：
HubSpotはAPIのレート制限を設けています（例えば、無料アプリの場合は10秒間に100リクエストまで）。複数のテーブルを同時に取り込む場合、これらのレート制限に達する可能性があり、その結果、取り込み処理が遅くなります。コネクタは、レート制限に達したリクエストを自動的に再試行します。
さらに、一部のテーブルでは、API 呼び出しの要件が高いために、取り込みに長い時間がかかることがあります。たとえば、 marketing_campaign_assetテーブルでは、キャンペーンごとに 24 回の個別の API 呼び出しが必要です。キャンペーンが 100 個ある場合、この 1 つのテーブルに対して約 2,400 回の API 呼び出しが必要になりますが、よりシンプルなテーブルの場合は約 5 回の API 呼び出しで済みます。これらのテーブルでは同期に長い時間がかかることが予想されます。たとえば、5,000 件のキャンペーンを含むテーブルの場合は、およそ 4 ～ 6 時間かかります。
適用可能なテーブルの完全なリストについては、 「バッチ更新のみをサポートするテーブル」を参照してください。
ソリューション:
一貫した取り込みパフォーマンスを確保するには:
- 同時に取り込むテーブルの数を制限します。
- テーブルを複数のパイプラインに分割し、異なる時間にスケジュールします。
- パイプラインの進行状況を監視し、実際の同期時間に基づいてスケジュール戦略を調整します。