Dépanner le connecteur Zoho Books
Bêta
Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.
Cette page décrit les erreurs courantes que vous pourriez rencontrer avec le connecteur géré Zoho Books et comment les résoudre.
Pour obtenir des recommandations générales de dépannage s'appliquant à tous les pipelines d'ingestion gérés, consultez Dépanner les pipelines d'ingestion gérés.
Jeton d'accès Zoho rejeté
Message d'erreur :
Zoho access token rejected. Refreshing credentials and retrying.
Cause : Zoho a renvoyé une réponse HTTP 401. Cela signifie généralement l'une des choses suivantes : les identifiants OAuth ne sont pas valides, le client autonome n'est pas autorisé pour les champs d'application requis, ou la région ne correspond pas à votre centre de données Zoho.
Solutions:
Le connecteur actualise automatiquement les informations d'identification et refresh. Si l'erreur persiste sur plusieurs exécutions de pipeline :
- Vérifiez que l’**identifiant client**, le **secret client**, l’**ID d’organisation** et la **région** de la connexion Unity Catalog correspondent à votre client Zoho Self et à votre organisation.
- Confirmez que le client autonome est autorisé pour les périmètres d'autorisation en lecture seule requis. Voir Champs d'application OAuth requis.
Pour plus de détails, consultez Configurer l'authentification pour Zoho Books.
Limite de débit de l’API Zoho Books dépassée
Message d'erreur :
Rate limit exceeded for Zoho Books API. Please retry the pipeline after some time.
Cause : Zoho a renvoyé une réponse HTTP 429. Zoho Books limite l'API à 100 requêtes par minute et par organisation, et à une limite d'appels par jour qui s'adapte à votre plan (1 000 appels sur le plan Gratuit, jusqu'à 10 000 sur les niveaux supérieurs). Consultez l'introduction à l'API Zoho Books.
Solutions:
Le connecteur attend et réessaye automatiquement. Si cela se produit de manière répétée, réduisez la fréquence de planification du pipeline ou le nombre de pipelines concurrents qui partagent la même organisation Zoho.
Zoho Books API temporairement indisponible
Message d'erreur :
Zoho Books API is temporarily unavailable. Please retry the pipeline after some time.
Cause : Zoho a renvoyé une erreur de serveur transitoire (HTTP 500, 502, 503 ou 504).
Solutions:
Le connecteur attend et réessaye automatiquement. Si le problème persiste, vérifiez l'état du service de Zoho.