Aller au contenu principal
Dernière mise à jour le

Dépanner l'ingestion Gmail

Cette page décrit les problèmes courants liés au connecteur d'ingestion Gmail dans Databricks Lakeflow Connect et comment les résoudre.

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.

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.

Erreur d’authentification (401)​

Une réponse 401 signifie que le connecteur n'a pas pu s'authentifier auprès de Gmail avec le compte de service. Vérifiez les points suivants :

  1. Confirmez que vous avez collé la clé JSON de compte de service complète et non modifiée lors de la création de la connexion Unity Catalog. Une clé tronquée ou mal formée entraîne l'échec de l'authentification.
  2. Confirmez que le compte de service dispose d'une délégation à l'échelle du domaine autorisée pour le périmètre https://www.googleapis.com/auth/gmail.readonly dans la console d'administration Google. Consultez Accorder une délégation à l'échelle du domaine.
  3. Confirmez que la boîte aux lettres que vous usurpez existe et se trouve dans le domaine Google Workspace pour lequel le compte de service est autorisé à déléguer.
  4. Si vous avez changé ou supprimé la clé de compte de service, créez une nouvelle clé et mettez à jour la connexion.

Erreur de quota ou de limite de débit (429 ou 403)​

Gmail applique des quotas d’API par utilisateur et par projet. Lorsque Gmail renvoie une réponse HTTP 403, le connecteur lit l’en-tête Retry-After (avec un délai d’attente minimal de 1 seconde) et relance automatiquement la demande ; ainsi, la limitation de débit temporaire se résout généralement sans intervention.

Si un pipeline continue de tomber en panne avec des erreurs de quota :

  • Réduisez la fréquence du calendrier du pipeline pour diminuer l’utilisation de l’API.
  • Confirmez que l'API Gmail est activée et que le quota de votre projet Google Cloud est suffisant dans la console Google Cloud sous APIs & Services > Quotas .

Expiration de historyId​

Les tables messages et message_labels utilisent un curseur historyId stocké pour la synchronisation incrémentielle. Si le pipeline s’exécute moins souvent que la fenêtre de rétention de l’historique de Gmail, Gmail expire le curseur et l’API History renvoie une erreur 404. Dans ce cas, le connecteur revient automatiquement à un refresh complet de la table concernée ; aucune action n’est donc requise. Pour éviter les refresh complets, planifiez l’exécution du pipeline assez fréquemment pour que le curseur reste dans la fenêtre de rétention de Gmail.

Obtenir de l'aide​

Si un problème persiste après avoir suivi ces étapes de dépannage, veuillez ouvrir un ticket d'assistance.

Sur cette page