Référence du connecteur Outlook

Cette page contient la documentation de référence pour le connecteur Outlook dans Lakeflow Connect.

Propriétés de connexion

Lorsque vous créez la connexion Unity Catalog, vous devez spécifier les propriétés suivantes. Voir Configurer l'authentification à Microsoft Outlook pour savoir comment obtenir ces valeurs.

Propriété	Description
ID client	L'ID d'application (client) de l'enregistrement de votre application Microsoft Entra ID.
Secret du client	La valeur du secret client de l'enregistrement de l'application Microsoft Entra ID.
ID du tenant	L'ID du répertoire (tenant) de l'enregistrement d'application Microsoft Entra ID.

Propriété	Description
ID client	L'ID d'application (client) de l'enregistrement de votre application Microsoft Entra ID.
Secret du client	La valeur du secret client de l'enregistrement de l'application Microsoft Entra ID.
ID du tenant	L'ID du répertoire (tenant) de l'enregistrement d'application Microsoft Entra ID.

Schéma de destination

Le connecteur produit une seule table, email_messages, sous le schéma default.

• Clé primaire : (mailbox, outlook_message_id)
• Curseur de synchronisation incrémentielle : received_at, suivi par boîte aux lettres et par dossier

email_messages

Colonne	Type	Description
mailbox	string	Adresse e-mail de la boîte aux lettres. Partie de la clé principale.
outlook_message_id	string	ID de message unique de l’API Microsoft Graphe. Partie de la clé principale.
internet_message_id	string	ID de message Internet RFC 2822.
conversation_id	string	ID du fil de discussion de la conversation.
folder	string	Nom d'affichage du dossier (par exemple, Inbox).
to_recipients	array<string>	Liste des adresses e-mail des destinataires.
cc_recipients	array<string>	Liste des adresses e-mail des destinataires en CC.
bcc_recipients	array<string>	Liste des adresses e-mail des destinataires en Cci.
from	string	Adresse e-mail de l'expéditeur.
sender	string	Adresse e-mail réelle de l’expéditeur (peut différer de from si l’envoi est fait pour le compte d’un tiers).
reply_to	array<string>	Liste d'adresses e-mail de réponse.
subject	string	Ligne d'objet de l'e-mail.
importance	string	Niveau d'importance (par exemple, normal, high, low).
is_read	boolean	Si le message a été lu ou non.
in_reply_to	string	ID du message Internet du message parent, à partir des en-têtes d'e-mail.
references	array<string>	Tableau des ID de message référencés, à partir des en-têtes d'e-mail.
body_preview	string	Aperçu du corps de l'e-mail.
full_body_content	string	Contenu complet du corps. Le format est HTML ou texte brut, selon l'option body_format.
unique_body_content	string	Contenu du corps unique, à l'exclusion du texte cité des réponses.
received_at	timestamp	Date et heure de réception du message (ISO-8601). Utilisé comme curseur de synchronisation incrémentielle.
sent_at	timestamp	Date et heure d'envoi du message (ISO-8601).
categories	array<string>	Catégories ou tags définis par l'utilisateur sur le message.
attachments	array<struct>	Tableau de structures de pièce jointe. Omis lorsque attachment_mode est NONE. Consultez Structure de pièce jointe.

Colonne	Type	Description
mailbox	string	Adresse e-mail de la boîte aux lettres. Partie de la clé principale.
outlook_message_id	string	ID de message unique de l’API Microsoft Graphe. Partie de la clé principale.
internet_message_id	string	ID de message Internet RFC 2822.
conversation_id	string	ID du fil de discussion de la conversation.
folder	string	Nom d'affichage du dossier (par exemple, Inbox).
to_recipients	array<string>	Liste des adresses e-mail des destinataires.
cc_recipients	array<string>	Liste des adresses e-mail des destinataires en CC.
bcc_recipients	array<string>	Liste des adresses e-mail des destinataires en Cci.
from	string	Adresse e-mail de l'expéditeur.
sender	string	Adresse e-mail réelle de l’expéditeur (peut différer de from si l’envoi est fait pour le compte d’un tiers).
reply_to	array<string>	Liste d'adresses e-mail de réponse.
subject	string	Ligne d'objet de l'e-mail.
importance	string	Niveau d'importance (par exemple, normal, high, low).
is_read	boolean	Si le message a été lu ou non.
in_reply_to	string	ID du message Internet du message parent, à partir des en-têtes d'e-mail.
references	array<string>	Tableau des ID de message référencés, à partir des en-têtes d'e-mail.
body_preview	string	Aperçu du corps de l'e-mail.
full_body_content	string	Contenu complet du corps. Le format est HTML ou texte brut, selon l'option body_format.
unique_body_content	string	Contenu du corps unique, à l'exclusion du texte cité des réponses.
received_at	timestamp	Date et heure de réception du message (ISO-8601). Utilisé comme curseur de synchronisation incrémentielle.
sent_at	timestamp	Date et heure d'envoi du message (ISO-8601).
categories	array<string>	Catégories ou tags définis par l'utilisateur sur le message.
attachments	array<struct>	Tableau de structures de pièce jointe. Omis lorsque attachment_mode est NONE. Consultez Structure de pièce jointe.

Structure de pièce jointe

Champ	Type	Description
attachment_id	string	ID de la pièce jointe de l'API Microsoft Graphe.
file_name	string	Nom de fichier d’origine.
mime_type	string	Type MIME (par exemple, application/pdf).
size	bigint	Taille du fichier en octets.
attachment_kind	string	Indicateur de type (par exemple, fileAttachment, itemAttachment).
is_inline	boolean	Si la pièce jointe est intégrée (par exemple, une image intégrée dans une signature).
content	binary	Contenu de fichier encodé en Base64.

Champ	Type	Description
attachment_id	string	ID de la pièce jointe de l'API Microsoft Graphe.
file_name	string	Nom de fichier d’origine.
mime_type	string	Type MIME (par exemple, application/pdf).
size	bigint	Taille du fichier en octets.
attachment_kind	string	Indicateur de type (par exemple, fileAttachment, itemAttachment).
is_inline	boolean	Si la pièce jointe est intégrée (par exemple, une image intégrée dans une signature).
content	binary	Contenu de fichier encodé en Base64.

Options du connecteur

Ces options sont spécifiées sous outlook_options dans la spécification du pipeline. Consultez Logique de combinaison des filtres pour savoir comment plusieurs options de filtre interagissent.

Option	Type	Obligatoire	Par défaut	Description
include_mailboxes	array<string>	Non	Toutes les boîtes aux lettres accessibles	Liste des adresses e-mail de la boîte aux lettres à synchroniser. Si ce n’est pas spécifié, le connecteur détecte et ingère toutes les boîtes aux lettres accessibles dans le tenant à l’aide de l’endpoint GET /users de Microsoft Graphe.
include_folders	array<string>	Non	["Inbox"]	Liste des noms d'affichage de dossiers à synchroniser. Exemples : Inbox, Sent Items, Custom_Folder. La correspondance est insensible à la casse.
include_senders	array<string>	Non	Tous les expéditeurs	Filtrer les e-mails par adresse e-mail de l'expéditeur en utilisant la correspondance exacte. Exemple : user@vendor.com.
include_subjects	array<string>	Non	Tous les sujets	Filtrer les e-mails par ligne d'objet. Les valeurs se terminant par * utilisent la correspondance de préfixe ; les autres valeurs utilisent la correspondance de sous-chaîne. Exemple : "Invoice" (sous-chaîne), "Re:*" (préfixe).
start_date	string	Non	Historique complet depuis l'époque	Date de start de la synchronisation initiale au format YYYY-MM-DD. Détermine la date la plus ancienne à partir de laquelle synchroniser les données historiques.
body_format	string	Non	TEXT_HTML	Contrôle le format du contenu du corps de l'e-mail. TEXT_HTML: préserve le formatage HTML complet. TEXT_PLAIN: convertit le corps en texte brut (recommandé pour les pipelines d'IA/RAG afin de réduire l'utilisation des jetons).
attachment_mode	string	Non	ALL	Contrôle les pièces jointes à ingérer. ALL: toutes les pièces jointes. NON_INLINE_ONLY: uniquement les pièces jointes non incorporées (recommandé pour éviter les images de signature d'entreprise). INLINE_ONLY: pièces jointes en ligne uniquement. NONE: aucune pièce jointe (ignore entièrement les appels d'API de pièce jointe).

Option	Type	Obligatoire	Par défaut	Description
include_mailboxes	array<string>	Non	Toutes les boîtes aux lettres accessibles	Liste des adresses e-mail de la boîte aux lettres à synchroniser. Si ce n’est pas spécifié, le connecteur détecte et ingère toutes les boîtes aux lettres accessibles dans le tenant à l’aide de l’endpoint GET /users de Microsoft Graphe.
include_folders	array<string>	Non	["Inbox"]	Liste des noms d'affichage de dossiers à synchroniser. Exemples : Inbox, Sent Items, Custom_Folder. La correspondance est insensible à la casse.
include_senders	array<string>	Non	Tous les expéditeurs	Filtrer les e-mails par adresse e-mail de l'expéditeur en utilisant la correspondance exacte. Exemple : user@vendor.com.
include_subjects	array<string>	Non	Tous les sujets	Filtrer les e-mails par ligne d'objet. Les valeurs se terminant par * utilisent la correspondance de préfixe ; les autres valeurs utilisent la correspondance de sous-chaîne. Exemple : "Invoice" (sous-chaîne), "Re:*" (préfixe).
start_date	string	Non	Historique complet depuis l'époque	Date de start de la synchronisation initiale au format YYYY-MM-DD. Détermine la date la plus ancienne à partir de laquelle synchroniser les données historiques.
body_format	string	Non	TEXT_HTML	Contrôle le format du contenu du corps de l'e-mail. TEXT_HTML: préserve le formatage HTML complet. TEXT_PLAIN: convertit le corps en texte brut (recommandé pour les pipelines d'IA/RAG afin de réduire l'utilisation des jetons).
attachment_mode	string	Non	ALL	Contrôle les pièces jointes à ingérer. ALL: toutes les pièces jointes. NON_INLINE_ONLY: uniquement les pièces jointes non incorporées (recommandé pour éviter les images de signature d'entreprise). INLINE_ONLY: pièces jointes en ligne uniquement. NONE: aucune pièce jointe (ignore entièrement les appels d'API de pièce jointe).

Logique de combinaison des filtres

Un e-mail est ingéré lorsqu'il correspond à au moins une valeur de chaque catégorie de filtre spécifiée. Plusieurs catégories de filtres sont combinées avec la logique ET ; les valeurs au sein d'une même catégorie utilisent la logique OU.

Exemple : include_folders=["Inbox"] ET include_senders=["user@vendor.com", "alerts@system.io"] ingèrent les e-mails du dossier Boîte de réception qui sont envoyés par user@vendor.com OU alerts@system.io.