Azure Data Factory または Synapse Analytics を使用して Microsoft 365 (Office 365) から Azure にコピーする

[アーティクル]
11/04/2024

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータサイエンス、リアルタイム分析、ビジネスインテリジェンス、レポートまで、あらゆるものをカバーしています。無料で新しい試用版を開始する方法について説明します。

Azure Data Factory および Synapse Analytics パイプラインは Microsoft Graph データ接続と統合されており、Microsoft 365 (Office 365) テナント内にある高機能な組織データを Azure へとスケーラブルに取り込み、分析アプリケーションを構築して、それらの貴重なデータ資産に基づくインサイトを抽出することができます。 Privileged Access Management との統合により、Microsoft 365 (Office 365) 内の貴重な選別済みデータをセキュリティで保護することができます。 Microsoft Graph データ接続の概要については、こちらのリンクを参照してください。

この記事では、コピーアクティビティを使って、Microsoft 365 (Office 365) からデータをコピーし、データフローでデータを変換する方法の概要を示します。データのコピーの概要については、コピーアクティビティの概要を参照してください。データの変換の概要については、マッピングデータフローの概要を参照してください。

注意

現在、Microsoft 365 Data Flow コネクタはプレビュー段階です。参加するには、M365 + Analytics プレビューのサインアップフォームを使用します。

サポートされる機能

この Microsoft 365 (Office 365) コネクタは、以下の機能でサポートされています。

サポートされる機能	IR
Copy アクティビティ (ソース/-)	①
マッピングデータフロー (ソース/-)	①

① Azure 統合ランタイム ② セルフホステッド統合ランタイム

ADF Microsoft 365 (Office 365) コネクタと Microsoft Graph データ接続を使うと、アドレス帳の連絡先、予定表イベント、メールメッセージ、ユーザー情報、メールボックスの設定など、Exchange Email 対応のメールボックスからさまざまな種類のデータセットを大量に取り込むことができます。使用できるデータセットの詳細な一覧については、こちらを参照してください。

現在、単一のコピーアクティビティとデータフロー内では、Microsoft 365 (Office 365) から Azure Blob Storage、Azure Data Lake Storage Gen1、Azure Data Lake Storage Gen2 に JSON 形式 (setOfObjects 型) でデータを取り込むことだけができます。 Azure Blob Storage にコピーする場合、出力は JSON テキストを含む BLOB です。 Microsoft 365 (Office 365) を他の種類のデータストアに読み込んだり、他の形式で読み込む必要がある場合は、最初のコピーアクティビティまたはデータフローを後続のアクティビティに連結して、任意のサポートされている ADF 変換先ストアにデータをさらに読み込むことができます (「サポートされるデータストアと形式」の表の「シンクとしてサポート」列をご覧ください)。

重要

データファクトリまたは Synapse ワークスペースとシンクデータストアを含んだ Azure サブスクリプションは、Microsoft 365 (Office 365) テナントと同じ Microsoft Entra テナントの下に配置する必要があります。
コピーアクティビティに使われる Azure Integration Runtime のリージョンおよびコピー先が、Microsoft 365 (Office 365) テナントユーザーのメールボックスの場所と同じリージョン内であることを確認します。 Azure IR の場所がどのように決定されるかについては、こちらをご覧ください。サポートされている Office リージョンと、対応する Azure リージョンの一覧については、こちらの表をご覧ください。
サービスプリンシパルの認証は、Azure Blob Storage、Azure Data Lake Storage Gen1、および Azure Data Lake Storage Gen2 で宛先ストアとしてサポートされている唯一の認証メカニズムです。

注意

ソースとシンクの両方のリンクされたサービスで Azure 統合ランタイムを使用してください。セルフホステッド統合ランタイムとマネージド仮想ネットワーク統合ランタイムはサポートされていません。

前提条件

Microsoft 365 (Office 365) から Azure にデータをコピーして変換するには、次の前提条件の手順を完了する必要があります。

Microsoft 365 (Office 365) テナントの管理者が、こちらの説明に従って、オンボーディングアクションを完了する必要があります。
Microsoft Entra ID で Microsoft Entra Web アプリケーションを作成し、構成します。手順については、Microsoft Entra アプリケーションの作成に関する記事を参照してください。
次の値を記録しておきます。Microsoft 365 (Office 365) 用のリンク済みサービスを定義するときに使います。
- テナント ID。手順については、「テナント ID を取得する」をご覧ください。
- アプリケーション ID とアプリケーションキー。手順については、「アプリケーション ID と認証キーを取得する」をご覧ください。
Microsoft Entra Web アプリケーションの所有者としてデータアクセス要求を行うユーザーの ID を追加します (Microsoft Entra Web アプリケーションから > [設定] > [所有者] > [所有者の追加])。
- ユーザー ID は、データの取得先の Microsoft 365 (Office 365) 組織に属している必要があり、ゲストユーザーであってはなりません。

新しいデータアクセス要求の承認

このコンテキスト (アクセスされようとしているデータテーブル、データが読み込まれようとしている宛先アカウント、データアクセス要求を行っているユーザー ID の組み合わせ) のデータを要求するのはこれが初めてである場合は、コピーアクティビティの状態が "In Progress (進行中)" として表示されます。[アクション] の下にある [詳細] リンクをクリックしたときにのみ、状態は "RequestingConsent" と表示されます。データの抽出を進めるには、データアクセス承認者グループのメンバーが、Privileged Access Management で要求を承認する必要があります。

承認者がデータアクセス要求を承認する方法については、こちらを参照してください。

作業の開始

ヒント

Microsoft 365 (Office 365) コネクタの使用に関するチュートリアルについては、Microsoft 365 (Office 365) からのデータ読み込み関する記事をご覧ください。

コピーアクティビティとデータフローを含むパイプラインは、次のいずれかのツールまたは SDK を使用して作成できます。リンクを選択すると、コピーアクティビティを含んだパイプラインの作成手順を詳しく説明したチュートリアルにアクセスできます。

UI を使用して Microsoft 365 (Office 365) のリンクサービスを作成する

次の手順を使用して、Azure portal UI で Microsoft 365 (Office 365) のリンクサービスを作成します。

Azure Data Factory または Synapse ワークスペースの [管理] タブに移動し、[リンクされたサービス] を選択して、[新規] をクリックします。
- Azure Data Factory
- Azure Synapse
Microsoft 365 (Office 365) を検索し、Microsoft 365 (Office 365) コネクタを選びます。
サービスの詳細を構成し、接続をテストして、新しいリンクサービスを作成します。

コネクタの構成の詳細

次のセクションでは、Microsoft 365 (Office 365) コネクタに固有の Data Factory エンティティを定義するために使用されるプロパティについて詳しく説明します。

リンクされたサービスのプロパティ

Microsoft 365 (Office 365) のリンクサービスでは、次のプロパティがサポートされます。

プロパティ	内容	必須
type	type プロパティは、次のように設定する必要があります:Office365	はい
office365TenantId	Microsoft 365 (Office 365) アカウントが属している Azure テナント ID です。	はい
servicePrincipalTenantId	Microsoft Entra Web アプリケーションが存在するテナントの情報を指定します。	はい
servicePrincipalId	アプリケーションのクライアント ID を取得します。	はい
servicePrincipalKey	アプリケーションのキーを取得します。安全に格納するには、このフィールドを SecureString とマークします。	はい
connectVia	データストアに接続するために使用される統合ランタイム。指定されていない場合は、既定の Azure 統合ランタイムが使用されます。	いいえ

注意

office365TenantId と servicePrincipalTenantId の違いと、対応する指定値:

自分の組織で使うための Microsoft 365 (Office 365) データに対するアプリケーションを開発しているエンタープライズ開発者は、両方のプロパティに同じテナント ID (組織の Microsoft Entra テナント ID) を指定する必要があります。
顧客用のアプリケーションを開発している ISV 開発者の場合は、office365TenantId が顧客の (アプリケーションインストーラー) Microsoft Entra テナント ID になり、servicePrincipalTenantId が自社の Microsoft Entra テナント ID になります。

例:

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

データセットのプロパティ

データセットを定義するために使用できるセクションとプロパティの完全な一覧については、データセットに関する記事をご覧ください。このセクションでは、Microsoft 365 (Office 365) データセットでサポートされるプロパティの一覧を示します。

Microsoft 365 (Office 365) からデータをコピーする場合、次のプロパティがサポートされます。

プロパティ	内容	必須
type	データセットの type プロパティは、次のように設定する必要があります:Office365Table に設定する必要があります。	はい
tableName	Microsoft 365 (Office 365) から抽出するデータセットの名前。抽出に使用できる Microsoft 365 (Office 365) データセットの一覧については、こちらをご覧ください。	はい

データセットに dateFilterColumn、startTime、endTime、userScopeFilterUri を設定していた場合は現状のまま引き続きサポートされますが、今後のアクティビティソースでは新しいモデルを使用することをお勧めします。

例

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

コピーアクティビティのプロパティ

アクティビティの定義に利用できるセクションとプロパティの完全な一覧については、パイプラインに関する記事を参照してください。このセクションでは、Microsoft 365 (Office 365) ソースでサポートされるプロパティの一覧を示します。

ソースとしての Microsoft 365 (Office 365)

Microsoft 365 (Office 365) からデータをコピーする場合、コピーアクティビティの source セクションでは次のプロパティがサポートされています。

プロパティ	内容	必須
type	コピーアクティビティのソースの type プロパティは、次のように設定する必要があります:Office365Source	はい
allowedGroups	グループ選択の述語。このプロパティを使用して、データの取得先のユーザーグループを最大 10 個まで選択します。グループが指定されていない場合、組織全体のデータが返されます。	いいえ
userScopeFilterUri	`allowedGroups` プロパティが指定されていない場合、テナント全体に適用される述語式を使って、特定の行をフィルター処理して Microsoft 365 (Office 365) から抽出することができます。述語の形式は、Microsoft Graph API のクエリ形式 (例: `https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'`) と一致している必要があります。	いいえ
dateFilterColumn	DateTime フィルター列の名前。 Microsoft 365 (Office 365) データを抽出する時間範囲を制限するには、このプロパティを使います。	はい (データセットに DateTime 列が 1 つ以上ある場合)。この DateTime フィルターが必要なデータセットの一覧については、こちらを参照してください。
startTime	フィルター処理する開始 DateTime の値。	はい (`dateFilterColumn` が指定されている場合)
endTime	フィルター処理する終了 DateTime の値。	はい (`dateFilterColumn` が指定されている場合)
outputColumns	シンクにコピーする列の配列。	いいえ

例:

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

Copy アクティビティでソースおよびシンクとしてサポートされるデータストアの一覧については、サポートされるデータストアに関するセクションを参照してください。

次の方法で共有

Azure Data Factory または Synapse Analytics を使用して Microsoft 365 (Office 365) から Azure にコピーする

サポートされる機能

前提条件

新しいデータアクセス要求の承認

作業の開始

UI を使用して Microsoft 365 (Office 365) のリンクサービスを作成する

コネクタの構成の詳細

リンクされたサービスのプロパティ

データセットのプロパティ

コピーアクティビティのプロパティ

ソースとしての Microsoft 365 (Office 365)

フィードバック

その他のリソース

次の方法で共有

Azure Data Factory または Synapse Analytics を使用して Microsoft 365 (Office 365) から Azure にコピーする

サポートされる機能

前提条件

新しいデータ アクセス要求の承認

作業の開始

UI を使用して Microsoft 365 (Office 365) のリンク サービスを作成する

コネクタの構成の詳細

リンクされたサービスのプロパティ

データセットのプロパティ

コピー アクティビティのプロパティ

ソースとしての Microsoft 365 (Office 365)

関連するコンテンツ

フィードバック

その他のリソース

新しいデータアクセス要求の承認

UI を使用して Microsoft 365 (Office 365) のリンクサービスを作成する

コピーアクティビティのプロパティ