Kopieren und Transformieren von Daten aus Microsoft 365 (Office 365) mithilfe von Azure Data Factory oder Synapse Analytics in Azure

  • Artikel

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

Azure Data Factory- und Synapse Analytics-Pipelines lassen sich in Microsoft Graph Data Connect integrieren, so dass Sie die umfangreichen Unternehmensdaten in Ihrem Microsoft 365 (Office 365)-Mandanten auf skalierbare Weise in Azure überführen und auf der Grundlage dieser wertvollen Datenbestände Analyseanwendungen erstellen sowie Erkenntnisse gewinnen können. Die Integration in Privileged Access Management bietet sichere Zugriffssteuerung für die wertvollen zusammengestellten Daten in Microsoft 365 (Office 365). Eine Übersicht über Microsoft Graph Data Connect finden Sie unter diesem Link.

In diesem Artikel wird beschrieben, wie Sie die Kopieraktivität zum Kopieren von Daten und den Datenfluss zum Umwandeln von Daten aus Microsoft 365 (Office 365) verwenden können. Eine Einführung in das Kopieren von Daten finden Sie in der Übersicht der Kopiervorgänge. Eine Einführung in die Transformation von Daten finden Sie in der Übersicht über die Zuordnung von Datenfluss.

Hinweis

Microsoft 365 Datenfluss-Connector ist derzeit als Vorschau verfügbar. Um teilzunehmen, verwenden Sie dieses Anmeldeformular: M365 + Analytics Preview.

Unterstützte Funktionen

Bei diesem Microsoft 365 (Office 365)-Connector werden die folgenden Funktionen unterstützt:

Unterstützte Funktionen IR
Kopieraktivität (Quelle/-) 0
Zuordnungsdatenfluss (Quelle/–) 0

① Azure Integration Runtime ② Selbstgehostete Integration Runtime

Der ADF Microsoft 365 (Office 365)-Connector und Microsoft Graph Data Connect ermöglichen die umfangreiche Erfassung verschiedener Datasettypen aus Exchange-E-Mail-fähigen Postfächern, einschließlich Adressbuchkontakten, Kalenderereignissen, E-Mail-Nachrichten, Benutzerinformationen, Postfacheinstellungen usw. Hier finden Sie die vollständige Liste verfügbarer Datasets.

Vorerst können Sie in einer einzelnen Kopieraktivität und in einem einzelnen Datenfluss Daten aus Microsoft 365 (Office 365) nur im JSON-Format („setOfObjects“-Typ) in Azure Blob Storage, Azure Data Lake Storage Gen1 und Azure Data Lake Storage Gen2 erfassen. Beim Kopieren in Azure Blob Storage ist die Ausgabe ein Blob mit JSON-Text. Wenn Sie Microsoft 365 (Office 365)-Daten in andere Typen von Datenspeichern oder in anderen Formaten laden möchten, können Sie die erste Kopieraktivität oder den ersten Datenfluss mit einer nachfolgenden Aktivität verketten, um Daten in einen der unterstützten ADF-Zielspeicher zu laden (siehe die Spalte „Als Senke unterstützt“ in der Tabelle „Unterstützte Datenspeicher und Formate“).

Wichtig

  • Das Azure-Abonnement, das die Data Factory oder den Synapse-Arbeitsbereich und den Senkendatenspeicher enthält, muss sich unter demselben Microsoft Entra-Mandanten wie der Microsoft 365 (Office 365)-Mandant befinden.
  • Sorgen Sie dafür, dass sich die für die Kopieraktivität verwendete Azure Integration Runtime-Region und das Ziel in derselben Region wie das Postfach der Benutzer des Microsoft 365 (Office 365)-Mandanten befinden. Hier erfahren Sie, wie der Azure Integration Runtime-Standort bestimmt wird. In dieser Tabelle finden Sie die Liste der unterstützten Office-Regionen und die entsprechenden Azure-Regionen.
  • Die Dienstprinzipalauthentifizierung ist der einzige Authentifizierungsmechanismus, der für Azure Blob Storage, Azure Data Lake Storage Gen1 und Azure Data Lake Storage Gen2 als Zielspeicher unterstützt wird.

Hinweis

Verwenden Sie Azure Integration Runtime sowohl in verknüpften Quellen- als auch in Senkendiensten. Die selbstgehostete Integration Runtime und die verwaltete Integration Runtime für virtuelle Netzwerke werden nicht unterstützt.

Voraussetzungen

Zum Kopieren und Transformieren von Daten aus Microsoft 365 (Office 365) in Azure müssen Sie die folgenden erforderlichen Schritte ausführen:

  • Ihr Microsoft 365- (Office 365)-Mandantenadministrator muss Onboarding-Aktionen ausführen, wie hier beschrieben wird.
  • Konfigurieren und erstellen einer Microsoft Entra-Webanwendung in Microsoft Entra ID. Anweisungen finden Sie unter Microsoft Entra-Anwendung.
  • Notieren Sie sich die folgenden Werte, die Sie zum Definieren des verknüpften Diensts für Microsoft 365 (Office 365) verwenden werden:
  • Fügen Sie die Identität des Benutzers, der die Datenzugriffsanforderung erstellt, als Besitzer der Microsoft Entra-Webanwendung hinzu (wählen Sie in der Microsoft Entra-Webanwendung > Einstellungen > Besitzer > Besitzer hinzufügen aus).
    • Die Benutzeridentität muss sich in der Microsoft 365 (Office 365)-Organisation befinden, von der Sie Daten erhalten. Sie darf kein Gastbenutzer sein.

Genehmigen neuer Datenzugriffsanforderungen

Wenn Sie erstmals Daten für diesen Kontext anfordern (also für eine Kombination daraus, auf welche Datentabelle zugegriffen wird, in welches Zielkonto die Daten geladen werden und welche Benutzeridentität die Datenzugriffsanforderung sendet), wird Ihnen als Status der Kopieraktivität „In Bearbeitung“ angezeigt. Nur wenn Sie unter „Aktionen“ auf den Link „Details“ klicken, wird als Status „RequestingConsent“ angezeigt. Ein Mitglied aus der Gruppe der Datenzugriffsgenehmiger muss die Anforderung in Privileged Access Management genehmigen, bevor die Datenextraktion fortgesetzt werden kann.

Hier erfahren Sie, wie die genehmigende Person die Datenzugriffsanforderung genehmigen kann, und hier finden Sie eine Erläuterung der allgemeinen Integration in Privileged Access Management, einschließlich Informationen zum Einrichten der Gruppe von genehmigenden Personen für den Datenzugriff.

Erste Schritte

Tipp

Eine exemplarische Vorgehensweise zur Verwendung des Microsoft 365 (Office 365)-Connectors finden Sie im Artikel zum Laden von Daten aus Microsoft 365 (Office 365).

Sie können mithilfe eines der folgenden Tools oder SDKs eine Pipeline mit der Copy-Aktivität und dem Datenfluss erstellen. Klicken Sie auf einen Link, um ein Tutorial mit Schritt-für-Schritt-Anweisungen zum Erstellen einer Pipeline mit einer Copy-Aktivität aufzurufen.

Erstellen eines verknüpften Diensts für Microsoft 365 (Office 365) über die Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um einen verknüpften Dienst zu Microsoft 365 (Office 365) auf der Benutzeroberfläche des Azure-Portals zu erstellen.

  1. Navigieren Sie in Ihrem Azure Data Factory- oder Synapse-Arbeitsbereich zu der Registerkarte „Verwalten“, wählen Sie „Verknüpfte Dienste“ aus und klicken Sie dann auf „Neu“:

  2. Suchen Sie nach Microsoft 365 (Office 365), und wählen Sie den Microsoft 365 (Office 365)-Connector aus.

    Screenshot of the Microsoft 365 (Office 365) connector.

  3. Konfigurieren Sie die Dienstdetails, testen Sie die Verbindung, und erstellen Sie den neuen verknüpften Dienst.

    Screenshot of linked service configuration for Microsoft 365 (Office 365).

Details zur Connector-Konfiguration

Die folgenden Abschnitte enthalten Details zu den Eigenschaften, die zum Definieren von Data Factory-Entitäten speziell für den Microsoft 365 (Office 365)-Connector verwendet werden.

Eigenschaften des verknüpften Diensts

Die folgenden Eigenschaften werden bei dem mit Microsoft 365 (Office 365) verknüpften Dienst unterstützt:

Eigenschaft Beschreibung Erforderlich
type Die type-Eigenschaft muss auf Folgendes festgelegt werden: Office365 Ja
office365TenantId Die Azure-Mandanten-ID, zu der das Microsoft 365 (Office 365)-Konto gehört. Ja
servicePrincipalTenantId Geben Sie die Mandanteninformationen Ihrer Microsoft Entra-Webanwendung an. Ja
servicePrincipalId Geben Sie die Client-ID der Anwendung an. Ja
servicePrincipalKey Geben Sie den Schlüssel der Anwendung an. Markieren Sie dieses Feld als „SecureString“, um es sicher zu speichern. Ja
connectVia Die Integration Runtime, die zum Herstellen einer Verbindung mit dem Datenspeicher verwendet werden soll. Wenn keine Option angegeben ist, wird die standardmäßige Azure Integration Runtime verwendet. Nein

Hinweis

Der Unterschied zwischen office365TenantId und servicePrincipalTenantId und der entsprechende anzugebende Wert:

  • Wenn Sie ein Unternehmensentwickler sind und eine Anwendung für Microsoft 365 (Office 365)-Daten zur Nutzung in Ihrer eigenen Organisation entwickeln, sollten Sie die gleiche Mandanten-ID für beide Eigenschaften angeben, und zwar die Microsoft Entra-Mandanten-ID Ihrer Organisation.
  • Wenn Sie ein ISV-Entwickler sind und eine Anwendung für Ihre Kunden entwickeln, ist „office365TenantId“ die Microsoft Entra-Mandanten-ID Ihres Kunden (der die Anwendung installiert), und „servicePrincipalTenantId“ ist die Microsoft Entra-Mandanten-ID Ihres Unternehmens.

Beispiel:

{
    "name": "Office365LinkedService",
    "properties": {
        "type": "Office365",
        "typeProperties": {
            "office365TenantId": "<Microsoft 365 (Office 365) tenant id>",
            "servicePrincipalTenantId": "<AAD app service principal tenant id>",
            "servicePrincipalId": "<AAD app service principal id>",
            "servicePrincipalKey": {
                "type": "SecureString",
                "value": "<AAD app service principal key>"
            }
        }
    }
}

Dataset-Eigenschaften

Eine vollständige Liste mit den Abschnitten und Eigenschaften, die zum Definieren von Datasets zur Verfügung stehen, finden Sie im Artikel zu Datasets. Dieser Abschnitt enthält eine Liste der Eigenschaften, die vom Microsoft 365 (Office 365)-Dataset unterstützt werden.

Beim Kopieren von Daten aus Microsoft 365 (Office 365) werden die folgenden Eigenschaften unterstützt:

Eigenschaft Beschreibung Erforderlich
type Die type-Eigenschaft des Datasets muss auf folgenden Wert festgelegt werden: Office365Table Ja
tableName Der Name des Datasets, das aus Microsoft 365 (Office 365) extrahiert werden soll. Hier finden Sie die Liste der Microsoft 365 (Office 365)-Datasets, die für die Extraktion verfügbar sind. Ja

Wenn Sie dateFilterColumn, startTime, endTime und userScopeFilterUri im Dataset festgelegt haben, wird es weiterhin unverändert unterstützt. Es wird jedoch empfohlen, zukünftig das neue Modell in der Aktivitätsquelle zu verwenden.

Beispiel

{
    "name": "DS_May2019_O365_Message",
    "properties": {
        "type": "Office365Table",
        "linkedServiceName": {
            "referenceName": "<Microsoft 365 (Office 365) linked service name>",
            "type": "LinkedServiceReference"
        },
        "schema": [],
        "typeProperties": {
            "tableName": "BasicDataSet_v0.Event_v1"
        }
    }
}

Eigenschaften der Kopieraktivität

Eine vollständige Liste mit den Abschnitten und Eigenschaften zum Definieren von Aktivitäten finden Sie im Artikel Pipelines. Dieser Abschnitt enthält eine Liste der Eigenschaften, die von der Microsoft 365 (Office 365)-Quelle unterstützt werden.

Microsoft 365 (Office 365) als Quelle

Beim Kopieren von Daten aus Microsoft 365 (Office 365) werden die folgenden Eigenschaften im Abschnitt source der Kopieraktivität unterstützt:

Eigenschaft Beschreibung Erforderlich
type Die type-Eigenschaft der Quelle der Kopieraktivität muss auf Folgendes festgelegt werden: Office365Source Ja
allowedGroups Gruppenauswahlprädikat. Verwenden Sie diese Eigenschaft, um bis zu 10 Benutzergruppen auszuwählen, für die die Daten abgerufen werden sollen. Wenn keine Gruppen angegeben sind, werden Daten für die gesamte Organisation zurückgegeben. Nein
userScopeFilterUri Wenn die Eigenschaft allowedGroups nicht angegeben ist, können Sie einen Prädikatsausdruck verwenden, der auf den gesamten Mandanten angewendet wird, um die spezifischen Zeilen zu filtern, die aus Microsoft 365 (Office 365) extrahiert werden sollen. Das Prädikatsformat sollte dem Abfrageformat von Microsoft Graph-APIs entsprechen, z.B. https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. Nein
dateFilterColumn Name der Filterspalte „DateTime“. Verwenden Sie diese Eigenschaft zum Begrenzen des Zeitraums, für den Microsoft 365 (Office 365)-Daten extrahiert werden. Ja, wenn das Dataset mindestens eine DateTime-Spalte enthält. Eine Liste der Datasets, die diesen DateTime-Filter benötigen, finden Sie hier.
startTime Start-DateTime-Value, nach dem gefiltert werden soll. Ja, wenn dateFilterColumn angegeben ist.
endTime End-DateTime-Value, nach dem gefiltert werden soll. Ja, wenn dateFilterColumn angegeben ist.
outputColumns Array der Spalten, die in die Senke kopiert werden sollen Nein

Beispiel:

"activities": [
    {
        "name": "CopyFromO365ToBlob",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Microsoft 365 (Office 365) input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "Office365Source",
                "dateFilterColumn": "CreatedDateTime",
                "startTime": "2019-04-28T16:00:00.000Z",
                "endTime": "2019-05-05T16:00:00.000Z",
                "userScopeFilterUri": "https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'",
                "outputColumns": [
                    {
                        "name": "Id"
                    },
                    {
                        "name": "CreatedDateTime"
                    },
                    {
                        "name": "LastModifiedDateTime"
                    },
                    {
                        "name": "ChangeKey"
                    },
                    {
                        "name": "Categories"
                    },
                    {
                        "name": "OriginalStartTimeZone"
                    },
                    {
                        "name": "OriginalEndTimeZone"
                    },
                    {
                        "name": "ResponseStatus"
                    },
                    {
                        "name": "iCalUId"
                    },
                    {
                        "name": "ReminderMinutesBeforeStart"
                    },
                    {
                        "name": "IsReminderOn"
                    },
                    {
                        "name": "HasAttachments"
                    },
                    {
                        "name": "Subject"
                    },
                    {
                        "name": "Body"
                    },
                    {
                        "name": "Importance"
                    },
                    {
                        "name": "Sensitivity"
                    },
                    {
                        "name": "Start"
                    },
                    {
                        "name": "End"
                    },
                    {
                        "name": "Location"
                    },
                    {
                        "name": "IsAllDay"
                    },
                    {
                        "name": "IsCancelled"
                    },
                    {
                        "name": "IsOrganizer"
                    },
                    {
                        "name": "Recurrence"
                    },
                    {
                        "name": "ResponseRequested"
                    },
                    {
                        "name": "ShowAs"
                    },
                    {
                        "name": "Type"
                    },
                    {
                        "name": "Attendees"
                    },
                    {
                        "name": "Organizer"
                    },
                    {
                        "name": "WebLink"
                    },
                    {
                        "name": "Attachments"
                    },
                    {
                        "name": "BodyPreview"
                    },
                    {
                        "name": "Locations"
                    },
                    {
                        "name": "OnlineMeetingUrl"
                    },
                    {
                        "name": "OriginalStart"
                    },
                    {
                        "name": "SeriesMasterId"
                    }
                ]
            },
            "sink": {
                "type": "BlobSink"
            }
        }
    }
]

Transformieren von Daten mit dem Microsoft 365-Connector

Microsoft 365-Datasets können als Quelle mit Zuordnungsdatenflüssen verwendet werden. Der Datenfluss transformiert die Daten, indem das Dataset automatisch vereinfacht wird. Auf diese Weise können sich Benutzer auf die Nutzung des vereinfachten Datasets konzentrieren, um ihre Analyseszenarien zu beschleunigen.

Eigenschaften von Mapping Data Flow

Führen Sie die folgenden Schritte aus, um einen Zuordnungsdatenfluss mithilfe des Microsoft 365-Connectors als Quelle zu erstellen:

  1. Wechseln Sie in ADF Studio zum Abschnitt Datenflüsse des Hubs Erstellen. Wählen Sie die Schaltfläche ... aus, um das Dropdownmenü Datenflussaktionen einzublenden, und dann das Element Neuer Datenfluss aus. Aktivieren Sie den Debugmodus mithilfe der Schaltfläche Datenfluss debuggen in der oberen Leiste der Datenflusscanvas.

    Screenshot of the data flow debug button in mapping data flow.

  2. Wählen Sie im Zuordnungsdatenfluss-Editor Quelle hinzufügen aus.

    Screenshot of add source in mapping data flow.

  3. Wählen Sie auf der Registerkarte QuelleinstellungenInline in der Eigenschaft Quelltyp, Microsoft 365 (Office 365) im Inline-Datasettyp und den zuvor erstellten verknüpften Microsoft 365-Dienst aus.

    Screenshot of the select dataset option in source settings of mapping data flow source.

  4. Wählen Sie auf der Registerkarte Quelloptionen den Tabellennamen der Microsoft 365-Tabelle aus, die Sie transformieren möchten. Wählen Sie auch die Option Automatisch vereinfachen aus, um zu entscheiden, ob der Datenfluss das Quelldatenset automatisch vereinfacht.

    Screenshot of the source options of mapping data flow source.

  5. Folgen Sie für die Registerkarten Projektion, Optimieren und Überprüfen dem Zuordnungsdatenfluss.

  6. Klicken Sie auf der Registerkarte Datenvorschau auf die Schaltfläche Aktualisieren, um ein Beispieldataset zur Überprüfung abzurufen.

Zugehöriger Inhalt

Eine Liste der Datenspeicher, die als Quelles und Senken für die Kopieraktivität unterstützt werden, finden Sie in der Dokumentation für Unterstützte Datenspeicher.