Kopieren von Microsoft 365 (Office 365) in Azure mithilfe von Azure Data Factory oder Synapse Analytics

Gilt für: Azure Data Factory Azure Synapse Analytics

Azure Data Factory- und Synapse Analytics-Pipelines sind in Microsoft Graph Data Connect integriert, sodass Sie die umfangreichen Organisationsdaten in Ihrem Microsoft 365-Mandanten (Office 365) auf skalierbare Weise in Azure bringen und Analyseanwendungen erstellen sowie Erkenntnisse aus diesen wertvollen Datenressourcen gewinnen können. Die Integration mit Privileged Access Management bietet eine gesicherte Zugriffssteuerung für die wertvollen kuratierten Daten in Microsoft 365 (Office 365). Eine Übersicht über Microsoft Graph Data Connect finden Sie unter link.

In diesem Artikel wird beschrieben, wie Sie mithilfe der Kopieraktivität Daten aus Microsoft 365 (Office 365) kopieren und mit dem Datenfluss Daten transformieren 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 das Datenfluss-Mapping.

Unterstützte Funktionen

Dieser Microsoft 365-Connector (Office 365) wird für die folgenden Funktionen unterstützt:

(1) Azure Integrationslaufzeit (2) Selbst gehostete Integrationslaufzeit

Der ADF-Microsoft-365-(Office-365)-Connector und Microsoft Graph Data Connect ermöglicht die Erfassung in großem Maßstab verschiedener Datensatztypen aus Exchange-E-Mail-fähigen Postfächern, einschließlich Adressbuchkontakten, Kalenderereignissen, E-Mail-Nachrichten, Benutzerinformationen, Postfacheinstellungen und so weiter. Hier finden Sie die vollständige Liste verfügbarer Datasets.

Derzeit können Sie nur innerhalb eines einzigen Kopiervorgangs und Datenflusses Daten aus Microsoft 365 (Office 365) in Azure Blob Storage, Azure Data Lake Storage Gen1 und Azure Data Lake Storage Gen2 im JSON-Format (Typ setOfObjects) importieren. Wenn Sie in Azure Blob Storage kopieren, handelt es sich bei der Ausgabe um ein BLOB mit JSON-Text. Wenn Sie Microsoft 365 (Office 365) in andere Datenspeicher oder in anderen Formaten importieren möchten, können Sie die erste Kopieraktivität oder den Datenfluss mit einer nachfolgenden Aktivität verketten, um Daten in eine der unterstützten ADF-Zielspeicher zu laden (siehe Spalte "Unterstützt als Ziel" in der Tabelle "Unterstützte Datenspeicher und Formate").

Voraussetzungen

Um Daten aus Microsoft 365 (Office 365) in Azure zu kopieren und zu transformieren, müssen Sie die folgenden erforderlichen Schritte ausführen:

• Der Administrator Ihres Microsoft 365 (Office 365)-Mandanten muss Onboarding-Aktionen ausführen, wie hier beschrieben.
• Erstellen und Konfigurieren einer Microsoft Entra Webanwendung in Microsoft Entra ID. Anweisungen finden Sie unter Create a Microsoft Entra application.
• Notieren Sie sich die folgenden Werte, mit denen Sie den verknüpften Dienst für Microsoft 365 (Office 365) definieren:
  • Mandanten-ID. Anweisungen finden Sie unter Abrufen der Mandanten-ID.
  • Anwendungs-ID und Authentifizierungsschlüssel. Anweisungen finden Sie unter Abrufen der Anwendungs-ID und des Authentifizierungsschlüssels.
• Fügen Sie die Benutzeridentität, die die Datenzugriffsanforderung erstellt, als Besitzer der Microsoft Entra Webanwendung hinzu (aus der Microsoft Entra Webanwendung > Einstellungen > Besitzer > Besitzer hinzufügen).
  • Die Benutzeridentität muss sich in der organisation Microsoft 365 (Office 365) befinden, aus der Sie Daten abrufen und kein Gastbenutzer sein dürfen.

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 Copy-Aktivität „In Bearbeitung“ angezeigt. Nur wenn Sie auf den Link „Details“unter „Aktionen“ klicken, wird als Status „Einwilligung wird angefordert“ angezeigt. Ein Mitglied aus der Gruppe der Datenzugriffsgenehmiger muss die Anforderung in Privileged Access Management genehmigen, bevor die Datenextraktion fortgesetzt werden kann.

Hier finden Sie Informationen darüber, wie die genehmigende Person die Datenzugriffsanforderung genehmigen kann.

Erste Schritte

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.

• Azure Portal
• .NET SDK
• Python SDK
• Azure PowerShell
• REST-API
• Azure Resource Manager-Vorlage.

Erstellen eines verknüpften Diensts zum Microsoft 365 (Office 365) mithilfe der Benutzeroberfläche

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

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

   • Azure Data Factory
   • Azure Synapse

   

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

   

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

   

Details zur Connector-Konfiguration

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

Eigenschaften des verknüpften Diensts

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

Beispiel 1: Verwendung der Authentifizierung mit Dienstprinzipalschlüssel

{
    "name": "Office365LinkedService",
    "properties": {
        "type": "Office365",
        "typeProperties": {
            "office365TenantId": "<Microsoft 365 (Office 365) tenant id>",
            "servicePrincipalTenantId": "<AAD app service principal tenant id>",
            "servicePrincipalCredentialType": "ServicePrincipalKey",
            "servicePrincipalId": "<AAD app service principal id>",
            "servicePrincipalKey": {
                "type": "SecureString",
                "value": "<AAD app service principal key>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Beispiel 2: Verwenden der Dienstprinzipal-Zertifikatauthentifizierung

{
    "name": "Office365LinkedService",
    "properties": {
        "type": "Office365",
        "typeProperties": {
            "office365TenantId": "<Microsoft 365 (Office 365) tenant id>",
            "servicePrincipalTenantId": "<AAD app service principal tenant id>",
            "servicePrincipalCredentialType": "ServicePrincipalCert",            
            "servicePrincipalId": "<AAD app service principal id>",
            "servicePrincipalEmbeddedCert": "<AAD app service principal cert in base64>",
            "servicePrincipalEmbeddedCertPassword": "<AAD app service principal cert password>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Speichern des Dienstprinzipalzertifikats in Azure Key Vault

Sie haben zwei Möglichkeiten, das Dienstprinzipalzertifikat in Azure Key Vault zu speichern:

• Option 1:

  1. Konvertieren Sie das Dienstprinzipalzertifikat in eine Base64-Zeichenfolge. Mehr dazu erfahren Sie in diesem Artikel.

  2. Speichern Sie die base64-Zeichenfolge als geheimen Schlüssel in Azure Key Vault.

     

     

• Option 2:

  Wenn Sie das Zertifikat von Azure Key Vault nicht herunterladen können, können Sie dieses verwenden, um das konvertierte Dienstprinzipalzertifikat als geheimer Schlüssel in Azure Key Vault zu speichern.

  

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 von Eigenschaften, die von Microsoft 365 -Datasets (Office 365) unterstützt werden.

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

Wenn Sie dateFilterColumn, startTime, endTime und userScopeFilterUri im Dataset festgelegt haben, wird dies 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 Microsoft 365 (Office 365)-Quelle unterstützt werden.

Microsoft 365 (Office 365) als Quelle

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

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"
            }
        }
    }
]

Zugehöriger Inhalt

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