メインコンテンツまでスキップ

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

備考

ベータ版

この機能はプレビューです。使用するには、ワークスペース管理者は プレビュー ページから Lakeflow Connect for SurveyMonkey を有効にする必要があります。Databricksプレビューの管理を参照してください。

Lakeflow Connect の管理対象 SurveyMonkey コネクタからのプラン制限、認証、および API レート制限エラーを解決します。

すべての管理されたインジェスト パイプラインに適用される一般的なトラブルシューティング ガイダンスについては、管理されたインジェスト パイプラインのトラブルシューティングを参照してください。

パイプラインがプラン制限エラーで失敗する​

エラーメッセージ:

SurveyMonkey returned 402 (plan limit): Basic plans are capped at 25 responses per survey. Upgrade to a paid plan for full response access.

原因: 承認アカウントのプランには要求されたデータへのアクセスが含まれていないため、SurveyMonkeyはHTTP 402レスポンスを返しました。「SurveyMonkeyスコープのリファレンス」を参照してください。

ソリューション:

認証を行うSurveyMonkeyアカウントが、直接APIアクセスを提供する有料プランを持っていることを確認します。プランの要件については、前提条件を参照してください。

パイプラインの認証に失敗しました​

原因: SurveyMonkey が HTTP 401 または 403 応答を返しました。これは通常、次のいずれかを意味します:クライアント資格情報が有効でない、ユーザーがアプリへのアクセスを取り消した、SurveyMonkeyが90日間のドラフト期間後にアプリを無効にした、またはアプリに必要なスコープがありません。

ソリューション:

  1. アプリがプライベートアプリとしてデプロイされていること、および必要なスコープがあることを確認してください。必要なOAuth権限を参照してください。
  2. Unity Catalog接続の データリージョン が、SurveyMonkeyアカウントをホストするデータセンターと一致していることを確認してください。
  3. 現在のクライアントIDとクライアントシークレットで接続を更新してから、もう一度SurveyMonkeyにサインインします。SurveyMonkey接続を作成するを参照してください。

SurveyMonkey APIレート制限を超過​

原因: アプリがリクエストの上限を超えたため、SurveyMonkeyはHTTP 429レスポンスを返しました。ドラフトアプリとプライベートアプリは、1分あたり120リクエストと、500リクエストから始まる1日あたりの上限に制限されています。1日の上限は、グリニッジ標準時 (GMT) の午前12:00にリセットされます。SurveyMonkey のリクエストおよびレスポンスの制限を参照してください。

ソリューション:

アプリが1分あたりの制限に達すると、コネクタは制限がResetされるのを待ってから自動的に再試行します。アプリが制限に達すると、パイプラインの更新はカーソルを進めることなく失敗し、次の更新は同じ時点から再開されます。これが繰り返される場合は、パイプラインのスケジュール頻度を減らすか、取り込むテーブルを減らすか、SurveyMonkeyに連絡してアプリの制限を増やすよう依頼してください。