Dépanner le connecteur Glean

info

Bêta

Cette fonctionnalité est en version bêta. Les administrateurs de Workspace peuvent contrôler l’accès à cette fonctionnalité depuis la page Aperçus . Consultez Gérer les aperçus Databricks.

Cette page décrit les erreurs courantes que vous pourriez rencontrer avec le connecteur Glean géré et comment les résoudre.

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

Échec de l’authentification du pipeline

Cause : Glean a renvoyé une réponse HTTP 401 ou HTTP 403 qui n’est pas une réponse de limitation de débit. Cela signifie généralement que le jeton API est non valide, que le jeton ne dispose pas de la portée pour la table en cours d’ingestion, ou que le sous-domaine ne correspond pas au déploiement qui a émis le jeton. Le connecteur traite ceci comme une erreur de configuration et fait échouer le pipeline.

Solutions:

1. Confirmez que le jeton API dans la connexion Unity Catalog est valide et n’a pas été révoqué.
2. Confirmez que le jeton comporte à la fois les périmètres Insights et Shortcuts. Un jeton auquel il manque un périmètre ne fonctionne pas uniquement pour la table qui en a besoin.
3. Confirmez que le sous-domaine dans la connexion Unity Catalog correspond au déploiement qui a émis le jeton.

Pour plus de détails, consultez Configurer l’authentification à Glean.

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

Cause : Glean a renvoyé une réponse HTTP 429 car le connecteur a envoyé trop de requêtes sur une courte période.

Solutions:

Le connecteur respecte l’en-tête de réponse Retry-After, puis revient à une interruption exponentielle et effectue des tentatives 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 simultanés qui partagent le même déploiement Glean.

L’API Glean est temporairement indisponible

Cause : Glean a renvoyé une erreur de serveur temporaire (HTTP 500, 502, 503 ou 504).

Solutions:

Le connecteur effectue automatiquement des tentatives avec un intervalle exponentiel. Si le problème persiste, patientez, puis exécutez à nouveau le pipeline.