Zoho Booksコネクタのトラブルシューティング
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、マネージドZoho Booksコネクタで発生する可能性のある一般的なエラーと、その解決方法について説明します。
Zoho のアクセストークンが拒否されました
エラーメッセージ：
Zoho access token rejected. Refreshing credentials and retrying.
原因： Zoho が HTTP 401応答を返しました。これは通常、次のいずれかを意味します：OAuth 認証情報が無効であるか、セルフクライアントが必要なスコープに対して承認されていないか、または、リージョンが Zoho データセンターと一致しないことです。
ソリューション:
コネクタは自動的に認証情報を更新し、再試行します。エラーが複数のパイプライン実行にわたって解消しない場合：
- Unity Catalog 接続における**クライアント ID**、**クライアント シークレット**、**組織 ID**、および**リージョン**が、Zoho Self Client および組織と一致していることを確認してください。
- セルフクライアントが、必要な読み取り専用スコープに対して承認されていることを確認してください。必要なOAuthスコープを参照してください。
詳細については、「Zoho Booksへの認証を構成する」を参照してください。
Zoho Books API のレート制限を超過しました
エラーメッセージ：
Rate limit exceeded for Zoho Books API. Please retry the pipeline after some time.
原因: ZohoからHTTP 429応答が返されました。Zoho Booksは、APIを組織あたり1分間に100リクエストに制限し、プランに応じてスケーリングされる1日あたりの呼び出し制限（Freeプランでは1,000回、上位プランでは最大10,000回）があります。Zoho Books APIの概要を参照してください。
ソリューション:
コネクタは待機して、自動的に再試行します。これが繰り返し発生する場合は、パイプラインのスケジュール頻度、または同じ Zoho 組織を共有する並列パイプラインの数を減らしてください。
Zoho Books API は一時的に利用できません
エラーメッセージ：
Zoho Books API is temporarily unavailable. Please retry the pipeline after some time.
原因： Zohoが一時的なサーバーエラーを返しました（HTTP 500、502、503、または504）。
ソリューション:
コネクタは自動的に待機して再試行します。問題が解決しない場合は、Zohoのサービスステータスを確認してください。