Xero コネクターのトラブルシューティング
ベータ版
この機能はベータ版です。使用するには、ワークスペース管理者が プレビュー ページから Lakeflow Connect for Xero を有効にする必要があります。Databricksのプレビューを管理するを参照してください。
Lakeflow ConnectのマネージドXeroコネクタの認証、アクセス、レート制限のエラーを解決します。
すべてのマネージド取り込みパイプラインに適用される一般的なトラブルシューティングのガイダンスについては、マネージド取り込みパイプラインのトラブルシューティングをご覧ください。
パイプラインの認証が失敗する
原因： Xero が HTTP 401 応答を返し、アクセストークンを更新しても解決しませんでした。通常、これは、更新トークンの有効期限が切れた、アプリのクライアントシークレットが変更された、またはユーザーが組織からアプリを切断したのいずれかを意味します。Xero は、60 日間使用されなかった更新トークンの有効期限を無効にします。「OAuth 2.0 FAQ」を参照してください。
ソリューション：
- Unity Catalog 接続の クライアント ID と クライアントシークレット が、Xero アプリと一致していることを確認してください。新しいシークレットを生成した場合は、接続を更新してください。「Xero 接続の作成」を参照してください。
- 接続から再度Xeroにサインインし、新しい更新トークンを取得します。
- 更新トークンが有効な状態を保てるよう、パイプラインが少なくとも60日ごとに実行されるようにスケジュールしてください。
Xero が組織へのアクセスを拒否しています
原因: Xero が HTTP 403 応答を返しました。これは通常、以下のいずれかを意味します。tenant_id オプションがアプリに接続された組織と一致しない、認証ユーザーが組織へのアクセス権を失った、または組織に Xero Projects など、テーブルに必要な製品がない。
ソリューション：
tenant_idが、アプリに接続されている組織のtenantIdであることを確認します。テナントIDの確認をご覧ください。- 認証ユーザーが、接続されたアプリの権限を持つ標準、アドバイザー、または管理者アクセス権を保持していることを確認します。パーミッションを参照してください。
- エラーが
projectsにのみ影響する場合は、組織が Xero Projects をサブスクライブしており、承認ユーザーが Projects ユーザーロールを持っていることを確認するか、そのテーブルをパイプラインから削除します。
Xero APIのレート制限を超過
原因: アプリがAPI制限を超えたため、XeroがHTTP 429応答を返しました。Xeroでは、組織ごとに1分あたり60回の呼び出し、および5回の並列呼び出しに制限しています。各組織の1日あたりの制限は、アプリの 開発者向け価格プラン によって異なります。API limits を参照してください。
ソリューション：
コネクタは、Retry-After ヘッダーに記載された時刻まで待機し、自動的に再試行します。この事象が繰り返し発生する場合は、パイプラインのスケジュール頻度を下げる、フル更新するテーブルの数を減らす、または同じ組織を呼び出すパイプラインやその他のアプリの数を減らしてください。