Kopiowanie z platformy Microsoft 365 (Office 365) na platformę Azure przy użyciu usługi Azure Data Factory lub Synapse Analytics

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Potoki usługi Azure Data Factory i Synapse Analytics integrują się z połączeniem danych programu Microsoft Graph, co pozwala na korzystanie z zaawansowanych danych organizacji w dzierżawie usługi Microsoft 365 (Office 365) na platformie Azure w skalowalny sposób i tworzenie aplikacji analitycznych oraz wyodrębnianie szczegółowych informacji na podstawie tych cennych zasobów danych. Integracja z usługą Privileged Access Management zapewnia bezpieczną kontrolę dostępu dla cennych wyselekcjonowanych danych na platformie Microsoft 365 (Office 365). Zapoznaj się z tym linkiem, aby zapoznać się z omówieniem połączenia danych programu Microsoft Graph.

W tym artykule opisano sposób używania działania kopiowania do kopiowania danych i Przepływ danych do przekształcania danych z platformy Microsoft 365 (Office 365). Aby zapoznać się z wprowadzeniem do kopiowania danych, przeczytaj omówienie działania kopiowania. Aby zapoznać się z wprowadzeniem do przekształcania danych, przeczytaj omówienie przepływu mapowania danych.

Obsługiwane możliwości

Ten łącznik usługi Microsoft 365 (Office 365) jest obsługiwany dla następujących funkcji:

(1) Środowisko Azure Integration Runtime (2) Self-hosted Integration Runtime

Łącznik usługi Microsoft 365 (Office 365) usługi ADF i program Microsoft Graph Data Connect umożliwia pozyskiwanie różnych typów zestawów danych z skrzynek pocztowych z włączoną obsługą poczty e-mail programu Exchange, w tym kontaktów z książką adresową, zdarzeniami kalendarza, wiadomościami e-mail, informacjami o użytkownikach, ustawieniami skrzynki pocztowej itd. Zapoznaj się z pełną listą dostępnych zestawów danych.

Na razie w ramach jednego działania kopiowania i przepływu danych można pozyskiwać tylko dane z platformy Microsoft 365 (Office 365) do usługi Azure Blob Storage, Azure Data Lake Storage Gen1 i Azure Data Lake Storage Gen2 w formacie JSON (typ setOfObjects). Podczas kopiowania do usługi Azure Blob Storage dane wyjściowe są obiektem blob zawierającym tekst JSON. Jeśli chcesz załadować usługę Microsoft 365 (Office 365) do innych typów magazynów danych lub w innych formatach, możesz połączyć pierwsze działanie kopiowania lub przepływ danych z kolejnym działaniem, aby dodatkowo załadować dane do dowolnego z obsługiwanych magazynów docelowych usługi ADF (zobacz kolumnę "obsługiwane jako ujście" w tabeli "Obsługiwane magazyny danych i formaty").

Wymagania wstępne

Aby skopiować i przekształcić dane z platformy Microsoft 365 (Office 365) na platformę Azure, należy wykonać następujące czynności wstępne:

• Administrator dzierżawy usługi Microsoft 365 (Office 365) musi wykonać akcje dołączania zgodnie z opisem tutaj.
• Utwórz i skonfiguruj aplikację internetową Firmy Microsoft Entra w identyfikatorze Entra firmy Microsoft. Aby uzyskać instrukcje, zobacz Tworzenie aplikacji firmy Microsoft Entra.
• Zanotuj następujące wartości, których używasz do definiowania połączonej usługi platformy Microsoft 365 (Office 365):
  • Identyfikator dzierżawy. Aby uzyskać instrukcje, zobacz Pobieranie identyfikatora dzierżawy.
  • Identyfikator aplikacji i klucz aplikacji. Aby uzyskać instrukcje, zobacz Pobieranie identyfikatora aplikacji i klucza uwierzytelniania.
• Dodaj tożsamość użytkownika, która wysyła żądanie dostępu do danych jako właściciel aplikacji internetowej Microsoft Entra (z witryny Microsoft Entra Web > Application Settings > Owner > Add owner).
  • Tożsamość użytkownika musi znajdować się w organizacji usługi Microsoft 365 (Office 365), z której uzyskujesz dane i nie może być użytkownikiem-gościem.

Zatwierdzanie nowych żądań dostępu do danych

Jeśli po raz pierwszy żądasz danych dla tego kontekstu (kombinacja, do której tabeli danych jest uzyskiwany dostęp, do którego konta docelowego są ładowane dane i do którego tożsamości użytkownika wysyła żądanie dostępu do danych), zobaczysz stan działania kopiowania jako "W toku", a dopiero po kliknięciu linku "Szczegóły" w obszarze Akcje zobaczysz stan "RequestingConsent". Przed kontynuowaniem wyodrębniania danych członek grupy osoby zatwierdzającej dostęp do danych musi zatwierdzić żądanie w usłudze Privileged Access Management.

Zapoznaj się z tym , jak osoba zatwierdzająca może zatwierdzić żądanie dostępu do danych.

Wprowadzenie

Potok można utworzyć za pomocą działania kopiowania i przepływu danych przy użyciu jednego z następujących narzędzi lub zestawów SDK. Wybierz link, aby przejść do samouczka z instrukcjami krok po kroku dotyczącymi tworzenia potoku z działaniem kopiowania.

• Witryna Azure Portal
• Zestaw SDK platformy .NET
• Zestaw SDK dla języka Python
• Azure PowerShell
• Interfejs API REST
• Szablon usługi Azure Resource Manager.

Tworzenie połączonej usługi z usługą Microsoft 365 (Office 365) przy użyciu interfejsu użytkownika

Wykonaj poniższe kroki, aby utworzyć połączoną usługę platformy Microsoft 365 (Office 365) w interfejsie użytkownika witryny Azure Portal.

1. Przejdź do karty Zarządzanie w obszarze roboczym usługi Azure Data Factory lub Synapse i wybierz pozycję Połączone usługi, a następnie kliknij pozycję Nowy:

   • Azure Data Factory
   • Azure Synapse

   

2. Wyszukaj usługę Microsoft 365 (Office 365) i wybierz łącznik usługi Microsoft 365 (Office 365).

   

3. Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.

   

Szczegóły konfiguracji łącznika

Poniższe sekcje zawierają szczegółowe informacje o właściwościach używanych do definiowania jednostek usługi Data Factory specyficznych dla łącznika usługi Microsoft 365 (Office 365).

Właściwości połączonej usługi

Następujące właściwości są obsługiwane w przypadku połączonej usługi Microsoft 365 (Office 365):

Przykład 1: Używanie uwierzytelniania klucza jednostki usługi

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

Przykład 2: Używanie uwierzytelniania certyfikatu jednostki usługi

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

Zapisz certyfikat jednostki usługi w usłudze Azure Key Vault

Istnieją dwie opcje zapisania certyfikatu jednostki usługi w usłudze Azure Key Vault:

• Opcja 1

  1. Przekonwertuj certyfikat jednostki usługi na ciąg base64. Dowiedz się więcej z tego artykułu.

  2. Zapisz ciąg base64 jako wpis tajny w usłudze Azure Key Vault.

     

     

• Opcja 2

  Jeśli nie możesz pobrać certyfikatu z usługi Azure Key Vault, możesz użyć tego szablonu , aby zapisać przekonwertowany certyfikat jednostki usługi jako wpis tajny w usłudze Azure Key Vault.

  

Właściwości zestawu danych

Pełna lista sekcji i właściwości dostępnych do definiowania zestawów danych znajduje się w artykule dotyczącym zestawów danych. Ta sekcja zawiera listę właściwości obsługiwanych przez zestaw danych usługi Microsoft 365 (Office 365).

Aby skopiować dane z usługi Microsoft 365 (Office 365), obsługiwane są następujące właściwości:

Jeśli ustawiono ustawienie dateFilterColumn, , startTimeendTimei userScopeFilterUri w zestawie danych, nadal jest obsługiwane zgodnie z rzeczywistym użyciem, podczas gdy sugerowane jest użycie nowego modelu w źródle działań.

Przykład

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

Właściwości działania kopiowania

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania działań, zobacz artykuł Pipelines (Potoki ). Ta sekcja zawiera listę właściwości obsługiwanych przez źródło usługi Microsoft 365 (Office 365).

Platforma Microsoft 365 (Office 365) jako źródło

Aby skopiować dane z usługi Microsoft 365 (Office 365), w sekcji źródła działania kopiowania są obsługiwane następujące właściwości:

Przykład:

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

Powiązana zawartość

Aby uzyskać listę magazynów danych obsługiwanych jako źródła i ujścia działania kopiowania, zobacz obsługiwane magazyny danych.