Résoudre les problèmes du connecteur Xero

info

Bêta

Cette fonctionnalité est en Bêta. Pour l'utiliser, un administrateur de workspace doit activer Lakeflow Connect pour Xero à partir de la page Aperçus . Consultez Gérer les aperçus Databricks.

Résoudre les erreurs d'authentification, d'accès et de limite de débit du connecteur Xero géré dans Lakeflow Connect.

Pour obtenir des conseils de dépannage généraux applicables à tous les pipelines d’ingestion gérés, consultez la rubrique Dépanner les pipelines d’ingestion gérés.

Échec de l'authentification du pipeline

Cause : Xero a renvoyé une réponse HTTP 401 et le rafraîchissement du jeton d'accès n'a pas résolu le problème. Cela signifie généralement l'une des choses suivantes : le token de refresh a expiré, le secret client de l'application a changé ou un utilisateur a déconnecté l'application de l'organisation. Xero expire les jetons de refresh qui ne sont pas utilisés pendant 60 jours. Consultez la FAQ OAuth 2.0.

Solution :

1. Vérifiez que le Client ID et le Client Secret dans la connexion Unity Catalog correspondent à votre application Xero. Si vous avez généré un nouveau secret, mettez à jour la connexion. Voir Création d’une connexion Xero.
2. Connectez-vous à nouveau à Xero à partir de la connexion pour obtenir un nouveau jeton de refresh.
3. Planifiez l’exécution du pipeline au moins tous les 60 jours pour que le jeton refresh reste valide.

Xero refuse l’accès à l’organisation

Cause : Xero a renvoyé une réponse HTTP 403. Cela signifie généralement l'une des choses suivantes : l'option tenant_id ne correspond pas à une organisation connectée à l'application, l'utilisateur qui autorise la connexion a perdu l'accès à l'organisation, ou l'organisation n'a pas le produit dont une table a besoin, comme Xero Projects.

Solution :

1. Vérifiez que tenant_id est le tenantId d'une organisation connectée à l'application. Voir Trouver l'ID du tenant.
2. Confirmez que l'utilisateur autorisant a toujours accès Standard, Adviser ou Administrator avec l'autorisation Connected Apps. Voir Autorisations.
3. Si l'erreur n'affecte que projects, confirmez que l'organisation est abonnée à Xero Projects et que l'utilisateur qui autorise dispose d'un rôle utilisateur Projects, ou supprimez cette table du pipeline.

Limite de débit de l’API Xero dépassée

Cause : Xero a renvoyé une réponse HTTP 429, car l’application a dépassé une limite de l’API. Xero limite chaque organisation à 60 appels par minute et à 5 appels simultanés. La limite quotidienne de chaque organisation dépend du niveau Tarifs développeur de votre application. Consultez les limites de l’API.

Solution :

Le connecteur attend le délai indiqué dans l’en-tête Retry-After et effectue une nouvelle tentative automatiquement. Si cela se produit fréquemment, réduisez la fréquence de planification du pipeline, ingérez moins de tables de refresh complet ou réduisez le nombre de pipelines et d’autres applications qui appellent la même organisation.