Forum aux questions sur la Connexion aux données Microsoft Graph
La Connexion aux données Microsoft Graph permet aux développeurs de créer des applications que les clients peuvent utiliser pour fournir un accès géré à leurs jeux de données Microsoft Graph à grande échelle. Cet article fournit des conseils qui vous aident à tirer parti de la fonctionnalité Connexion aux données Microsoft Graph. Pour une présentation de la Connexion aux données Microsoft Graph, consultez la vue d’ensemble.
Pour plus de questions, consultez Résolution des problèmes ou création d’une demande de support Azure avec les sélections suivantes :
- Type de service : choisissez LES API High-Capacity Microsoft Graph
- Type de problème : choisissez Microsoft Graph Data Connect (MGDC)
La Connexion aux données Microsoft Graph est-elle pour moi ?
Les API Microsoft Graph Data Connect et Microsoft Graph permettent d’accéder aux mêmes données sous-jacentes, mais de manière très différente. Microsoft Graph Data Connect est conçu pour extraire de grandes quantités de jeux de données en bloc, évolutifs pour l’ensemble de votre organisation. tandis que les API Microsoft Graph conviennent pour accéder à une petite quantité de données à partir d’utilisateurs et de groupes sélectionnés dans votre organisation.
Par exemple, vous pouvez utiliser Microsoft Graph Data Connect pour effectuer une extraction initiale des données de la dernière année de messagerie, puis utiliser les API Microsoft Graph pour analyser les e-mails en temps réel. Microsoft Graph Data Connect et les API Microsoft Graph sont des outils différents pour différents travaux. Veillez à utiliser la méthode d’accès la mieux adaptée à votre scénario. Pour plus d’informations, consultez Quand dois-je utiliser l’API Microsoft Graph ou Microsoft Graph Data Connect.
Dans quels scénarios les entreprises utilisent-elles des données Microsoft 365 ?
Il existe un certain nombre de cas d’usage qui peuvent être alimentés par des données Microsoft 365. Voici quelques-uns des principaux scénarios qui intéressent les clients :
Analyse de la relation client : Pour les chefs d’entreprise commerciaux, allez au-delà des insights CRM traditionnels et comprenez les interactions et les relations client en fonction des modèles de communication et de collaboration.
Business Process Analytics : pour de meilleures opérations, découvrez comment le travail transite réellement dans l’organisation au quotidien. Identifiez les processus manuels et les goulots d’étranglement de flux de travail qui doivent être automatisés ou optimisés.
Analyse de la sécurité et de la conformité : pour sécuriser les données sensibles, découvrez comment les employés utilisent et partagent des informations sensibles. Implémentez la détection des anomalies, le renseignement sur les menaces, l’analyse des journaux d’audit, la gestion des risques et l’investigation juridique.
People Productivity Analytics : Pour favoriser la transformation, exportez vos métriques de productivité Viva, afin de pouvoir convertir des insights en solutions d’adoption numérique, de réunions et de contenu intelligents, d’espaces de travail hybrides et de changement culturel.
En quoi Viva Insights et Microsoft Graph Data Connect diffèrent-ils ?
Viva Insights et Microsoft Graph Data Connect sont complémentaires. Bien que les deux s’appuient sur Microsoft 365, Viva Insights et Data Connect servent des audiences et des besoins différents.
Lorsque les clients recherchent des insights et des analyses au-delà de Viva Insights, Data Connect offre l’extensibilité pour répondre à des exigences personnalisées. Par exemple, il propose des enregistrements et des transcriptions d’appels Teams, ainsi que des jeux de données SharePoint Online, qui ne sont pas actuellement dans l’étendue de Viva Insights. En outre, les données brutes Data Connect fournissent des détails granulaires qui ne sont pas autrement disponibles à partir de Viva Insights.
Y a-t-il une surcharge initiale avec Microsoft Graph Data Connect ?
Étant donné que la Connexion aux données est conçue pour extraire de grandes quantités de données en bloc, un traitement initial s’impose avant l’extraction des données. Cette surcharge est d’environ 45 minutes, ce qui signifie que tous les pipelines prennent au moins autant de temps, quelle que soit la taille des données. Si la surcharge initiale est trop longue pour votre cas d’usage, créez une demande de support Azure, y compris les détails mentionnés dans la section précédente.
Dans quelles régions Microsoft Graph Data Connect est-il disponible ?
Microsoft Graph Data Connect est actuellement disponible dans plusieurs régions des zones géographiques suivantes : Amérique du Nord, Europe, Asie-Pacifique, Royaume-Uni/Grande-Bretagne et Australie. D’autres régions seront disponibles à l’avenir.
Pour obtenir la liste des régions et mappages Office vers Azure, consultez Jeu de données, régions et récepteurs.
Quels jeux de données sont disponibles via Microsoft Graph Data Connect ?
Les types de jeux de données suivants sont disponibles :
De base : jeux de données générés à partir du contenu brut créé par le client et des entrées à partir d’applications et de services Microsoft 365 (par exemple, id Microsoft Entra, Outlook ou jeux de données Teams).
Nettoyé : jeux de données générés par la normalisation et la déduplication à partir de jeux de données de base, ou jeux de données créés à partir de signaux d’activité ou de comportement de l’utilisateur dans Microsoft 365 (par exemple, jeux de données SharePoint, Office 365).
Organisé : jeux de données personnalisés générés pour un cas d’usage ou des scénarios d’analyse spécifiques, ou jeux de données provenant d’applications d’analyse Microsoft 365 internes pour leur extensibilité, par exemple les métriques Viva Insights).
Plusieurs jeux de données pour chacun des éléments suivants sont disponibles :
- Teams
- Outlook
- Identifiant Microsoft Entra
- OneDrive/Sharepoint
- Viva Insights
De nouveaux jeux de données sont régulièrement ajoutés à Microsoft Graph Data Connect. Pour obtenir la liste complète, consultez Jeu de données, régions et récepteurs.
Quels jeux de données sont en préversion et lesquels sont généralement disponibles ?
Pour plus d’informations sur les jeux de données généralement disponibles ou en préversion uniquement, consultez Jeu de données, régions et récepteurs.
Comment la facturation est-elle calculée ?
Microsoft Graph Data Connect facture les clients sur une base mensuelle et effectue également un arrondi fractionnable lors du calcul de la facture. Chaque exécution de pipeline est facturée séparément.
Par exemple, un client a 20 exécutions de pipeline au cours du mois, chacune produisant 500 lignes. Au total, le client exécute des pipelines pour 10 000 lignes ce mois-là. Toutefois, leur facture ne sera pas de 10 000 lignes/1 000 lignes = 10 unités.
Au lieu de cela, le client est facturé pour 20 unités, car Microsoft Graph Data Connect arrondit les fractions. Étant donné que 500 lignes/1 000 lignes = 0,5 et 0,5 est une fraction, elle arrondit à 1. Le client est facturé une unité par exécution de pipeline, ce qui se traduit par 20 unités facturées au total.
Que puis-je faire si un jeu de données n’est pas encore pris en charge pour mon locataire ?
Pour les jeux de données en préversion, vérifiez que vous répondez aux critères décrits dans Jeux de données, régions et récepteurs. Ces jeux de données ne sont disponibles que pour les clients qui ont choisi de les utiliser explicitement.
Pour toute question, créez une demande de support Azure, y compris les détails mentionnés dans la section précédente.
Pour quels scénarios Microsoft Graph Data Connect est-il le mieux adapté ?
Les organisations qui peuvent exploiter les jeux de données volumineux qui alimentent leurs outils de productivité peuvent obtenir des informations considérables sur les défis et les opportunités qu’elles peuvent rencontrer. Les clients créent des applications dans plusieurs scénarios, tels que les réseaux d’organisation pour l’analytique de la productivité des personnes, le surpartage des informations pour l’analyse de la sécurité et de la conformité, les forces de relation vendeur pour l’analyse de la relation client, etc.
Mes données peuvent-elles rester dans l’abonnement de l’organisation avec la Connexion aux données Microsoft Graph ?
Microsoft Graph Data Connect respecte la limite de locataire de votre organisation lors de la remise des jeux de données demandés. Les ressources Azure et les services Microsoft 365 doivent se trouver dans la même location Microsoft Entra pour accéder à votre jeu de données Microsoft 365. L’accès aux jeux de données interlocataires n’est pas disponible aujourd’hui.
Les principaux du service sont-ils requis avec la Connexion aux données Microsoft Graph ?
Lorsque vous créez le pipeline Azure Synapse ou Data Factory, vous devez fournir un principal de service au service lié Microsoft 365. Dans Azure, un principal de service est une identité de sécurité qui représente une application ou un service (par opposition à un utilisateur). La Connection aux données Microsoft Graph utilise ce principal de service comme identité lors de l’obtention d’un accès autorisé à vos données Microsoft 365.
Si vous créez une application managée Azure que d’autres utilisateurs peuvent utiliser dans leurs clients, vous fournissez toujours un principal de service pour l’application à utiliser. Ce principal de service existe dans votre client (le serveur de publication). Toutefois, si l’application a besoin d’autres principaux de service, votre client (le programme d’installation) les crée dans son propre client. Par exemple, votre pipeline Azure Synapse ou Azure Data Factory a probablement besoin d’accéder à une ressource de stockage dans Azure. Le client crée le principal de service avec des autorisations sur le compte de stockage que le pipeline doit utiliser.
Pour plus d’informations sur la création de votre application avec Azure Synapse ou Azure Data Factory, consultez le guide de démarrage rapide Data Connect.
Chaque exécution de pipeline nécessite-t-elle une nouvelle demande de consentement ?
Tant que l’étendue des données extraites reste la même pour les jeux de données, les colonnes, les utilisateurs et le récepteur, l’exécution du pipeline ne nécessite pas de nouvelle demande de consentement. Au lieu de cela, le pipeline utilise le consentement actif approuvé. L’exécution d’un pipeline avec la même étendue pour différentes dates ne nécessite pas de nouveau consentement.
Puis-je dédupliquer les e-mails en cas de besoin ?
Lorsque vous extrayez des e-mails du jeu de données Message, il existe souvent plusieurs objets JSON pour le même e-mail. Ces doublons existent, car lorsqu’un e-mail est envoyé à plusieurs personnes, il y a une copie de l’e-mail dans la boîte aux lettres de chaque destinataire. Étant donné que le jeu de données est extrait de chaque boîte aux lettres, il contient toutes les copies entre les utilisateurs. Dans certains scénarios, il peut être nécessaire de conserver chaque copie, mais dans d’autres, vous souhaiterez peut-être supprimer les doublons.
Vous pouvez dédupliquer les objets JSON exportés en fonction de la internetMessageId des messages : deux messages avec le même internetMessageId sont des copies dupliquées de la même instance. Comme les doublons peuvent se trouver dans différents objets blob, vous devez procéder à la déduplication sur tous les objets blob et non séparément sur chaque objet blob.
Puis-je utiliser le champ puser pour déterminer l’utilisateur approprié ?
Les données extraites incluent des métapropriétés qui n’existent pas lorsque les API Microsoft Graph correspondantes sont utilisées. Plus précisément, le champ puser peut être utile pour déterminer à partir de quel utilisateur les données ont été extraites. Si vous disposez de deux copies du même e-mail dans des boîtes aux lettres différentes, vous pouvez utiliser le champ puser pour déterminer quelle copie provient de quelle boîte aux lettres. Le champ puser est également utile pour les jeux de données tels que le jeu de données Manager. Le fichier JSON exporté contient des informations sur un responsable, mais cela n’est utile que si vous savez de qui il s’agit. Le champ puser vous indique à quel gestionnaire correspond cet objet JSON.
La configuration de client en mode hybride est-elle prise en charge ?
Si votre configuration Microsoft 365 comporte des utilisateurs dans Exchange Online et d’autres dans Exchange en local, les utilisateurs qui se trouvent dans Exchange en local ne sont pas pris en charge. Malheureusement, La connexion aux données n’est actuellement pas prise en charge pour les utilisateurs Exchange locaux.
Les comptes de ressource sont-ils pris en charge ?
Nous ne prenons actuellement pas en charge l’accès aux messages ou événements à partir des comptes de ressource.
Pourquoi est-ce que je vois parfois plusieurs fichiers par exécution de pipeline ADF, mais d’autres fois un seul fichier par exécution ?
La Connexion aux données Microsoft Graph prend la liste des utilisateurs pour chaque exécution de pipeline, puis distribue l’extraction et la curation du jeu de données sur plusieurs travaux qui s’exécutent en parallèle. Pour chaque exécution parallèle, un fichier de sortie est généré dans le récepteur de données défini par vous. Dans certains cas, si la liste d’utilisateurs est petite, elles peuvent être mappées dans un travail d’extraction et de curation, et dans ce cas, un seul fichier de sortie est généré dans le récepteur de données.