Azure Data Factory を使用して Microsoft 365 (Office 365) からデータを読み込む

[アーティクル]
07/24/2023

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

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

この記事では、Data Factory を使用して Microsoft 365 (Office 365) から Azure BLOB ストレージにデータを読み込む 方法を示します。同様の手順に従って Azure Data Lake Gen1 または Gen2 にデータをコピーすることもできます。 Microsoft 365 (Office 365) からデータをコピーするための一般的な方法については、Microsoft 365 (Office 365) コネクタに関する記事を参照してください。

Data Factory の作成

データファクトリをまだ作成していない場合は、「クイックスタート: Azure portal と Azure Data Factory Studio を使用してデータファクトリを作成する」の手順に従って作成してください。作成した後、Azure portal 内のデータファクトリに移動します。
[Open Azure Data Factory Studio](Azure Data Factory Studio を開く) タイルで [開く] を選択して、別のタブでデータ統合アプリケーションを起動します。

パイプラインを作成する

ホームページで [調整] を選択します。
パイプラインの [全般] タブで、パイプラインの名前として「CopyPipeline」と入力します。
[アクティビティ] ツールボックスの [移動と変換] > カテゴリ>で、ツールボックスからパイプラインデザイナー画面にCopy アクティビティをドラッグアンドドロップします。アクティビティ名として "CopyFromOffice365ToBlob" を指定します。

注意

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

ソースの構成

パイプライン >[ソース] タブに移動し、[+ 新規] を選択してソースデータセットを作成します。
[新しいデータセット] ウィンドウ内で [Microsoft 365] (Office 365) を選択し、[続行] を選択します。
コピーアクティビティの構成のタブが表示されます。Microsoft 365 (Office 365) データセットの横にある [編集] ボタンを選択して、データの構成を続行します。
Microsoft 365 (Office 365) データセット用の新しいタブが開きます。プロパティウィンドウの下部にある [全般] タブで、[名前] に「SourceOffice365Dataset」と入力します。
プロパティウィンドウの [接続] タブに移動します。 [リンクされたサービス] ボックスの横にある [+ 新規] を選択します。
[New Linked Service]\(新しいリンクされたサービス) ウィンドウで、名前として「Office365LinkedService」と入力し、サービスプリンシパル ID とサービスプリンシパルキーを入力したら、接続をテストし、 [作成] を選択して、リンクされたサービスをデプロイします。
リンクされたサービスが作成されると、データセットの設定に戻ります。 [テーブル] の横にある下向き矢印を選択し、使用可能な Microsoft 365 (Office 365) データセットの一覧を展開して、ドロップダウンリストから "BasicDataSet_v0.Message_v0" を選択します。
次に、[パイプライン]>[ソース] タブに戻り、Microsoft 365 (Office 365) のデータ抽出のために引き続き追加プロパティを構成します。ユーザースコープとユーザースコープフィルターは、Microsoft 365 (Office 365) から抽出するデータを制限するために定義できる省略可能な述語です。これらの設定を構成する方法については、Microsoft 365 (Office 365) のデータセットのプロパティに関するセクションを参照してください。
日付フィルターの 1 つを選択し、開始時刻と終了時刻の値を指定する必要があります。
[インポートスキーマ] タブを選択して、メッセージデータセットのスキーマをインポートします。

シンクの構成

パイプライン >[シンク] タブに移動し、[+ 新規] を選んでシンクデータセットを作成します。
[新しいデータセット] ウィンドウでは、Microsoft 365 (Office 365) からコピーするときに、サポートされているコピー先のみが選択されていることに注意してください。 [Azure Blob Storage] を選択し、[バイナリ形式] を選択して、 [続行] を選択します。このチュートリアルでは、Microsoft 365 (Office 365) のデータを Azure Blob Storage にコピーします。
Azure Blob Storage データセットの横にある [編集] ボタンを選択して、データの構成を続行します。
プロパティウィンドウの [General](一般) タブの [名前] に「OutputBlobDataset」と入力します。
プロパティウィンドウの [接続] タブに移動します。 [リンクされたサービス] ボックスの横にある [+ 新規] を選択します。
[New Linked Service]\(新しいリンクされたサービス) ウィンドウで、名前として「AzureStorageLinkedService」と入力し、認証方法のドロップダウンリストから [サービスプリンシパル] を選択します。サービスエンドポイント、テナント、サービスプリンシパル ID、およびサービスプリンシパルキーを入力したら、[保存] を選択し、リンクされたサービスをデプロイします。 Azure Blob Storage のサービスプリンシパルの認証を設定する方法については、ここを参照してください。

パイプラインを検証する

パイプラインを検証するには、ツールバーから [検証] を選択します。

右上隅にある [コード] をクリックすると、パイプラインに関連付けられている JSON コードを参照することもできます。

パイプラインを発行する

上部ツールバーの [すべて発行] を選択します。これにより、作成したエンティティ (データセットとパイプライン) が Data Factory に発行されます。

Publish changes

パイプラインを手動でトリガーする

ツールバーの [トリガーの追加] を選択し、 [Trigger Now](今すぐトリガー) を選択します。 [Pipeline Run](パイプラインの実行) ページで [完了] を選択します。

パイプラインの監視

左側の [監視] タブに移動します。手動トリガーによってトリガーされたパイプラインの実行が表示されます。 [アクション] 列のリンクを使用して、アクティビティの詳細を表示したりパイプラインを再実行したりできます。

Monitor pipeline

パイプラインの実行に関連付けられているアクティビティの実行を表示するには、[アクション] 列の [View Activity Runs](アクティビティの実行の表示) リンクを選択します。この例では、アクティビティが 1 つだけなので、一覧に表示されるエントリは 1 つのみです。コピー操作の詳細を確認するには、[アクション] 列の [詳細] リンク (眼鏡アイコン) を選択します。

Monitor activity

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

同意を要求しているときの状態: Activity execution details - request consent