Configurer Microsoft 365 dans une activité de copie

Les pipelines de données Microsoft Fabric s’intègrent à la connexion aux données Microsoft Graph, ce qui vous permet d’apporter les données organisationnelles enrichies de votre locataire Microsoft 365 dans Fabric et Azure de manière scalable ainsi que de créer des applications d’analytique et d’extraire des insights basés sur ces précieuses ressources de données. L’intégration à Privileged Access Management fournit un contrôle d’accès sécurisé pour les précieuses données organisées dans Microsoft 365. Consultez ce lien pour obtenir une vue d’ensemble de la connexion de données Microsoft Graph.

Cet article explique comment utiliser l’activité Copy dans un pipeline de données pour copier des données à partir de Microsoft 365. Pour l’instant, au sein d’une activité de copie unique, vous pouvez ingérer des données de Microsoft 365 dans la table Microsoft Fabric Lakehouse, Stockage Blob Azure, Azure Data Lake Storage Gen1 et Azure Data Lake Storage Gen2. Le format de données pris en charge est Avro, le texte délimité, JSON, ORC et Parquet.

Prérequis

Pour copier des données depuis Microsoft 365, vous devez effectuer les étapes prérequises suivantes :

• L’administrateur de votre locataire Microsoft 365 doit effectuer des actions d’intégration comme décrit ici.
• Créez et configurez une application web Microsoft Entra dans l’ID Microsoft Entra. Pour obtenir des instructions, consultez Créer une application Microsoft Entra.
• Prenez note des valeurs suivantes, que vous utiliserez afin de définir la connexion pour Microsoft 365 : ID de locataire. Pour obtenir des instructions, consultez Obtenir l’ID de locataire.
• ID d’application et clé d’application. Pour obtenir des instructions, consultez Obtenir un ID d’application et une clé d’authentification. Ajoutez l’identité de l’utilisateur effectuant la demande d’accès aux données en tant que propriétaire de l’application web Microsoft Entra (à partir de l’application web Microsoft Entra >Paramètres>Propriétaires>Ajouter un propriétaire).
• L’identité de l’utilisateur doit être dans l’organisation Microsoft 365 à partir de laquelle vous obtenez des données et ne doit pas être un utilisateur Invité.

Approbation de nouvelles demandes d’accès aux données

Si c’est la première fois que vous demandez des données pour ce contexte (une combinaison de la table de données consultée, du compte de destination dans lequel les données sont chargées et de l’identité de l’utilisateur à l’origine de la demande d’accès aux données), vous voyez l’activité Copy avec l’état En cours. Ce n’est que lorsque vous sélectionnez le lien Détails sous Actions que l’état s’affiche en tant que RequestingConsent. Un membre du groupe d’approbateurs pour l’accès aux données doit approuver la requête dans Privileged Access Management pour permettre l’extraction de données.

Reportez-vous aux questions fréquemment posées sur la façon dont l’approbateur peut approuver la demande d’accès aux données. Reportez-vous à l’article Intégration de la connexion de données à PAM pour obtenir une explication de l’intégration globale à Privileged Access Management, y compris la configuration du groupe d’approbateurs d’accès aux données.

Configuration prise en charge

Pour la configuration de chaque onglet sous l’activité de copie, accédez respectivement aux sections suivantes.

• Généralités
• Source
• Mappage
• Paramètres

Général

Pour la configuration de l’onglet Général, accédez à Général.

Source

Les propriétés suivantes sont prises en charge pour Microsoft 365 sous l’onglet Source d’une activité Copy.

Les propriétés suivantes sont requises :

• Type de magasin de données : sélectionnez Externe.
• Connexion : sélectionnez une connexion Microsoft 365 dans la liste des connexions. Si aucune connexion n’existe, créez une connexion Microsoft 365 en sélectionnant Nouveau.
• Table : nom de la table à extraire de Microsoft 365. Vous pouvez afficher un aperçu des exemples de données en sélectionnant Aperçu des exemples de données.

Sous Avancé, vous pouvez spécifier les champs suivants :

• Étendue : vous pouvez sélectionner Tous les utilisateurs ou groupes du client Microsoft 365 ou Sélectionner des groupes du client Microsoft 365

  Si vous sélectionnez Tous les utilisateurs ou groupes du client Microsoft 365, le filtre d’étendue s’affiche.

  

  • Filtre d’étendue : vous pouvez utiliser une expression de prédicat appliquée sur l’ensemble du locataire pour filtrer les lignes spécifiques à extraire de Microsoft 365. Le format de prédicat doit correspondre au format de requête des API Microsoft Graph, par exemple, https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'.

  Si vous sélectionnez Sélectionner des groupes du client Microsoft 365, vous pouvez sélectionner Ajouter des groupes d’utilisateurs pour sélectionner des groupes à partir du locataire Microsoft 365. Cette propriété permet de sélectionner jusqu'à 10 groupes d’utilisateurs pour lesquels les données seront récupérées. Si aucun groupe n’est spécifié, les données sont retournées pour toute l’organisation.

  

• Filtre de date : spécifiez le nom de la colonne de filtre DateTime. Cette propriété permet de limiter l’intervalle de temps pour lequel les données Microsoft 365 sont extraites. Si votre jeu de données comporte une ou plusieurs colonnes DateHeure, vous devez spécifier une colonne ici. Reportez-vous à Filtrage pour obtenir la liste des jeux de données qui nécessitent ce filtre DateHeure.

  Spécifiez l’heure de début (UTC) et l’heure de fin (UTC) sur lesquelles filtrer lorsque vous sélectionnez une colonne de filtre DateHeure.

  

Mappage

Pour la configuration de l’onglet Mappage, accédez à Configurer vos mappages sous l’onglet Mappage.

Paramètres

Pour la configuration de l’onglet Paramètres, accédez à Configurer vos autres paramètres sous l’onglet Paramètres.

Résumé sous forme de tableaux

Les tableaux suivants contiennent plus d’informations sur l’activité Copy dans Microsoft 365.

Informations sur la source

Nom	Description	Valeur	Obligatoire	Propriété de script JSON
Type de banque de données	Votre type de magasin de données.	Externe	Oui	/
Connection	Votre connexion au magasin de données source.	<votre connexion>	Oui	connection
Table	Nom de la table à extraire de Microsoft 365.	<table>	Oui	table
Portée	Lorsque le groupe d’utilisateurs n’est pas spécifiée, vous pouvez utiliser une expression de prédicat appliquée sur l’ensemble du locataire pour filtrer les lignes spécifiques à extraire de Microsoft 365. Le format de prédicat doit correspondre au format de requête des API Microsoft Graph, par exemple, https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'.	<votre étendue>	Oui	scope
Filtre d’étendue	Lorsque la propriété allowedGroups n’est pas spécifiée, vous pouvez utiliser une expression de prédicat appliquée sur l’ensemble du locataire pour filtrer les lignes spécifiques à extraire de Microsoft 365. Le format de prédicat doit correspondre au format de requête des API Microsoft Graph, par exemple, https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'.	<filtre d’étendue>	Non	userScopeFilterUri
ID de groupe	Prédicat de sélection de groupe. Cette propriété permet de sélectionner jusqu'à 10 groupes d’utilisateurs pour lesquels les données seront récupérées. Si aucun groupe n’est spécifié, les données sont retournées pour toute l’organisation.	<id de groupe>	Non	allowedGroups
Filtre de date (Nom de colonne)	Nom de la colonne de filtre de date/heure. Cette propriété permet de limiter l’intervalle de temps pour lequel les données Microsoft 365 sont extraites.	<votre colonne de filtre DateHeure>	Oui, si les données comportent une ou plusieurs colonnes DateHeure.	dateFilterColumn
Heure de début (UTC)	Valeur de date/heure de début sur laquelle filtrer.	<heure de début>	Oui, si dateFilterColumn est spécifié	startTime
Heure de fin (UTC)	Valeur de date/heure de fin sur laquelle filtrer.	<heure de fin>	Oui, si dateFilterColumn est spécifié	endTime

Contenu connexe

• Guide pratique pour créer une connexion Microsoft 365