Dépanner le connecteur Outlook

info

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 problèmes courants avec le connecteur Outlook dans Databricks Lakeflow Connect et comment les résoudre.

Pour obtenir des conseils de dépannage généraux qui s'appliquent à tous les pipelines d'ingestion gérés, consultez Dépannage des pipelines d'ingestion gérés.

Authentifié, mais les données Outlook ne sont pas visibles

Problème : l'authentification a réussi, mais aucune donnée Outlook n'apparaît dans la table de destination.

Résolution :

• Confirmez que l'enregistrement d'application dispose des autorisations d' application Microsoft Graphe API requises (User.Read.All ou Directory.Read.All, et Mail.Read) et que le consentement de l'administrateur a été accordé.
• Confirmez que les boîtes aux lettres spécifiées dans include_mailboxes (si fournies) correspondent à des boîtes aux lettres Exchange Online actives.
• Confirmez que la connexion a été créée avec l'ID client, la clé secrète client et l'ID de tenant corrects. Modifiez la connexion dans l'Explorateur de catalogue pour vérifier.

Erreur de privilèges insuffisants

Problème : Le pipeline échoue avec une erreur de privilèges insuffisants.

Résolution :

• Confirmez que l'enregistrement de l'application dispose des autorisations d' application correctes de l'API Microsoft Graph, et non des autorisations déléguées.
• Confirmez qu'un administrateur a cliqué sur **Accorder le consentement d'administrateur** pour les autorisations requises dans le portail Azure.

MailboxNotEnabledForRESTAPI erreur

Problème : Le connecteur signale une erreur MailboxNotEnabledForRESTAPI pour une ou plusieurs boîtes aux lettres.

Résolution :

• Cette erreur indique que la boîte aux lettres n'est pas activée pour l'API REST Microsoft Graphe. Cela se produit généralement pour les boîtes aux lettres on-premise ou les boîtes aux lettres qui n'ont pas été migrées vers Exchange Online. Le connecteur ignore automatiquement ces boîtes aux lettres avec un avertissement et poursuit l'ingestion pour les boîtes aux lettres restantes.

Jeton expiré ou erreur de secret client non valide

Problème : Le pipeline échoue avec une erreur de jeton expiré ou de secret client invalide.

Résolution :

• Les secrets client dans Microsoft Entra ID ont une date d'expiration. Si le secret a expiré :
  1. Créez un secret client dans l’enregistrement de l’application sous Certificats et secrets .
  2. Mettez à jour la connexion dans Databricks avec la nouvelle valeur du secret client.

Le connecteur tente automatiquement d’actualiser le jeton OAuth lorsqu’il reçoit une réponse HTTP 401 de l’API Microsoft Graphe.

Les dossiers spécifiés ne sont pas ingérés

Problème : Les e-mails d'un dossier spécifié dans include_folders n'apparaissent pas dans la table de destination.

Résolution :

• La correspondance des dossiers est insensible à la casse, mais le nom du dossier doit correspondre exactement au nom d'affichage tel qu'il apparaît dans Outlook. Vérifiez le nom d'affichage dans la boîte aux lettres cible.
• Si un dossier spécifié n'existe pas dans une boîte aux lettres, le connecteur l'ignore silencieusement. Consultez les logs de pipeline pour les avertissements d'omission.

Besoin d'aide ?

Si vous rencontrez un problème qui n'est pas couvert par ce guide de dépannage, créez un ticket d'assistance.