Oracle Eloquaコネクタのトラブルシューティング
ベータ版
この機能はベータ版です。使用するには、ワークスペース管理者は、 プレビュー ページから Oracle Eloqua向けLakeflow Connect を有効にする必要があります。Databricksプレビューの管理を参照してください。
Lakeflow Connectのマネージド Oracle Eloquaコネクタの接続、サインイン、認証、アクセス、レート制限のエラーを解決します。
すべてのマネージド インジェスト パイプラインに適用される一般的なトラブルシューティング ガイダンスについては、マネージド インジェスト パイプラインのトラブルシューティングを参照してください。
APIベースURLが無効です
エラーメッセージ:
API Base URL must be an https host with no path, e.g. https://secure.p03.eloqua.com; received '<value>'.
原因: 接続内の API ベース URL が、ホストのみを含む https URL ではありません。たとえば、値には /API/REST/2.0 などのパスが含まれます。
ソリューション:
インスタンスのベース URL のスキームとホストのみを入力します (例: https://secure.p03.eloqua.com)。ベース URL を見つけるには、 「ステップ 2: API ベース URL を見つける」を参照してください。
許可試行回数が多すぎるため、サインインに失敗しました
エラーメッセージ:
This user has already authorized this app within the allowed time frame of 60 seconds.
原因: Oracle Eloquaは、アプリの各ユーザーに対して1分に1回のOAuth認可の開始を受け付け、追加の試行に対してHTTP 429レスポンスを返します。「OAuth 2.0を使用した認証」を参照してください。
ソリューション:
少なくとも60秒待ってから、もう一度 Sign in with Oracle Eloqua をクリックします。
接続作成がサインイン後に失敗する
原因: Oracle Eloqua認可コードは、Oracle Eloquaが発行してから60秒後に期限切れになります。コードがその時間内にトークンと交換されない場合、Oracle Eloquaはそれを拒否し、接続は作成されません。OAuth 2.0を使用した認証を参照してください。
ソリューション:
[ Oracle Eloqua でサインイン ] をもう一度クリックして、遅滞なくサインインを完了します。Oracle Eloqua が多すぎる認証試行を報告している場合は、 「多すぎる認証試行が原因でサインインが失敗する」を参照してください。
リダイレクトURIのエラーによりサインインに失敗する
原因: Oracle Eloqua が invalid_redirect_uri エラー(エラーコード 2509)を返しました。Oracle Eloqua アプリの「 OAuthコールバックURL 」が、Databricks が送信するリダイレクトURIと一致していません。
ソリューション:
設定 > AppCloud Developer でアプリを開き、 OAuthコールバックURL にhttps://<workspace-url>/login/oauth/http.htmlを設定します。「ステップ1:Oracle Eloquaアプリを登録する」を参照してください。
パイプラインの認証に失敗しました
原因: Oracle EloquaがHTTP 401レスポンスを返しました。これは通常、次のいずれかを意味します:Oracle Eloquaユーザーがアプリケーションのアクセスを取り消した、更新トークンの有効期限が切れた、またはインスタンスが別のポッドに移動した。Oracle Eloquaの更新トークンは、使用されない場合、1年後に有効期限が切れます。
ソリューション:
- 接続の APIベースURL が、インスタンスの現在のベースURLと一致していることを確認してください。ステップ2: APIベースURLを見つけるを参照してください。
- 接続の承認を再作成します。Oracle Eloqua接続の作成を参照してください。
パイプラインがアクセスエラーで失敗しました
原因: Oracle EloquaがHTTP 403レスポンスを返しました。接続を許可したOracle Eloquaユーザーに、要求されたデータを読み取る権限がありません。
ソリューション:
Oracle Eloqua管理者にユーザーにデータへのアクセス権を付与するよう依頼するか、アクセス権を持つユーザーとして接続認証を再作成します。「Oracle Eloqua接続の作成」を参照してください。
Oracle Eloqua API のレート制限を超過しました
原因: コネクタが短期間に多数のリクエストを送信したため、Oracle EloquaがHTTP 429応答を返しました。
ソリューション:
コネクタが待機して自動的に再試行します。これが繰り返し発生する場合は、パイプラインのスケジュール頻度、または同じ Oracle Eloqua インスタンスを共有する並列パイプラインの数を減らしてください。