FAQ du connecteur Gmail
Cette page répond aux questions fréquentes sur le connecteur Gmail dans Databricks Lakeflow Connect.
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.
FAQ sur les connecteurs gérés généraux
Les réponses figurant dans la FAQ sur les connecteurs gérés s'appliquent à tous les connecteurs gérés dans Lakeflow Connect. Continuez votre lecture pour consulter les FAQ spécifiques à Gmail.
FAQ spécifiques au connecteur
Les réponses de cette section sont spécifiques au connecteur Gmail.
À partir de quelle boîte aux lettres le connecteur lit-il ?
Le connecteur lit à partir d'une seule boîte aux lettres par connexion. Le compte de service usurpe l'identité de la boîte aux lettres que vous spécifiez avec une délégation à l'échelle du domaine et l'option de connecteur mailbox (default me). Le connecteur marque la valeur de la boîte aux lettres en tant que colonne mailbox sur chaque ligne.
Quelles tables sont synchronisées de manière incrémentielle et lesquelles font l'objet d'un refresh complet ?
Les tables messages et message_labels se synchronisent de manière incrémentielle à l’aide de l’API Gmail History. Les tables profile, labels, labels_details, drafts et filters sont uniquement en full-refresh et sont réingérées intégralement à chaque exécution du pipeline.
Comment les pièces jointes sont-elles ingérées ?
Les pièces jointes sont contenues dans la colonne payload de la table messages, à payload.parts[].body.attachmentId. Il n’existe pas de table de pièces jointes distincte.
Comment ingérer plusieurs boîtes aux lettres ?
Chaque connexion ingère une seule boîte aux lettres. Pour ingérer plusieurs boîtes aux lettres, créez une connexion et un pipeline distincts pour chaque boîte aux lettres. Vous pouvez distinguer les boîtes aux lettres dans vos tables de destination en utilisant la colonne mailbox.
Que se passe-t-il si historyId expire ?
Le connecteur stocke un curseur historyId pour récupérer les modifications incrémentales. Si Gmail expire le curseur (l’API History renvoie une erreur 404 car le curseur est plus ancien que la fenêtre de rétention de Gmail), le connecteur revient automatiquement à un full refresh de la table concernée. Pour éviter cela, planifiez l’exécution du pipeline au moins une fois tous les sept jours, ce qui maintient le curseur dans la fenêtre de rétention de Gmail.
Le connecteur peut-il modifier ma boîte aux lettres ?
Non. Le connecteur est en lecture seule. Il nécessite le champ d’application https://www.googleapis.com/auth/gmail.readonly et communique uniquement avec https://gmail.googleapis.com. Il ne modifie jamais la boîte aux lettres source.