Microsoft Graph データ接続でサポートされているデータセット、地域、シンク
Microsoft Graph データ接続は、Microsoft Azure でさまざまなデータセット、データ領域、ストレージの場所をサポートしています。 この記事では、サポートされているデータセットと、データセット スキーマ、サポートされている Microsoft 365 および Microsoft Azure リージョン、および Microsoft Graph Data Connect が Azure Synapse または Azure Data Factory を介して利用するストレージの場所にアクセスする方法について説明します。
データセット
Microsoft Graph Data Connect では現在、次のデータセットがサポートされています。 各データセットのスキーマを表示するには、Azure Synapse または Azure Data Factory で新しいデータセットを作成し、[スキーマ] タブに移動します。
アクティビティ
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| OutlookContactActivity_v0 | Microsoft Outlook での連絡先に対する従業員のアクティビティを提供します。 | データセットのOutlookContactActivity_v0 |
| OutlookMailActivity_v0 | Outlook で従業員のアクティビティにメールを提供します。 | データセットのOutlookMailActivity_v0 |
| OutlookMeetingActivity_v0 | Outlook での会議で従業員のアクティビティを提供します。 | データセットのOutlookMeetingActivity_v0 |
| TeamsChannelActivity_v0 | Microsoft Teamsのチャネルでemployeesのアクティビティを提供します。 | データセットのTeamsChannelActivity_v0 |
| TeamsConversationActivity_v0 | Teams でのチームとチャットで従業員のアクティビティを提供します。 | データセットのTeamsConversationActivity_v0 |
通話レコード
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| TeamsCallRecords_v1 | Teams の呼び出しと会議からのアクティビティ レコードを提供します。 | データセットのTeamsCallRecords_v1 |
チャネル
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| TeamsChannelDetails_v0 | Microsoft Teams チャネルの一覧を生成します。 | データセットのTeamsChannelDetails_v0 |
Contact
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| Contact_v0 | 各ユーザーのアドレス帳から利用できる連絡先の詳細を提供します。 | データセットのContact_v0 |
| Contact_v1 | 各ユーザーのアドレス帳から利用できる連絡先の詳細を提供します。 | データセットのContact_v1 |
デバイスとライセンス
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| OwnedDevices_v0 | 組織内の各ユーザーが所有するすべてのデバイスに関連する詳細情報を提供します。 | データセットのOwnedDevices_v0 |
| RegisteredDevices_v0 | ユーザーが組織内で登録されているすべてのデバイスに関連する詳細情報を提供します。 | データセットのRegisteredDevices_v0 |
| LicenseDetails_v0 | 直接割り当てられているユーザーのライセンスと、ライセンスグループのメンバーシップを通じて推移的に割り当てられたユーザーのライセンスの詳細を提供します。 | データセットのLicenseDetails_v0 |
イベント
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| CalendarView_v0 | ユーザーの予定表からの予定表ビューに基づいて、イベントの発生、例外、および単一インスタンスを提供します。 | データセットのCalendarView_v0 |
| ConferenceRoomCalendar_v0 | テナント用に作成された会議室の CalendarView データを提供します。 | データセットのConferenceRoomCalendar_v0 |
| Event_v0 | ユーザーの予定表からすべてのイベントを提供します。 | データセットのEvent_v0 |
| Event_v1 | ユーザーの予定表からすべてのイベントを提供します。 | データセットのEvent_v1 |
グループ
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| GroupDetails_v0 | テナントの Microsoft Entra ID (Azure AD) グループ データを提供します。 | データセットのGroupDetails_v0 |
| GroupMembers_v0 | すべてのグループの直接メンバーの一覧を生成します。 | データセットのGroupMembers_v0 |
| GroupOwners_v0 | すべてのグループ所有者の一覧を取得します。 | データセットのGroupOwners_v0 |
メール
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| Message_v0 | メール フォルダー内のユーザーが受信したすべてのメッセージのコレクションを提供します。 | データセットのMessage_v0 |
| Message_v1 | メール フォルダー内のユーザーが受信したすべてのメッセージのコレクションを提供します。 | データセットのMessage_v1 |
| SentItems_v0 | テナントのすべてのユーザーが送信したすべての電子メールのコレクションを提供します。 | データセットのSentItems_v0 |
| SentItems_v1 | 送信されたすべての電子メールのコレクションに、いくつかの追加フィールドを提供します。 | データセットのSentItems_v1 |
メール フォルダー
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| Inbox_v1 | ユーザーのメール フォルダーからのメッセージを提供します。 | データセットのInbox_v1 |
| Mailfolder_v0 | ユーザーのメールボックスに作成されたすべてのフォルダーに関する情報を提供します。 | データセットのMailfolder_v0 |
| Mailfolder_v2 | ユーザーのメールボックスに作成されたすべてのメール フォルダーに関する情報を提供します。 | データセットのMailfolder_v2 |
メールボックス設定
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| MailboxSettings_v0 | すべてのユーザーのメールボックス設定の詳細を提供します。 | データセットのMailboxSettings_v0 |
メッセージ
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| OutlookGroupConversations_v0 | テナントのユーザー間のグループ会話のコレクションを提供します。 | データセットのOutlookGroupConversations_v0 |
| TeamChat_v1 | 1 対 1 のチャット メッセージとグループ チャット メッセージに対して Teams チャット メッセージを提供します。 | データセットのTeamChat_v1 |
| TeamChat_v2 | 1 対 1 のチャット メッセージとグループ チャット メッセージに対して Teams チャット メッセージを提供します。 | データセットのTeamChat_v2 |
| TeamsStandardChannelMessages_v0 | Teams の標準チャネルからのチャネル投稿とメッセージを提供します。 | データセットのTeamsStandardChannelMessages_v0 |
オンライン会議
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| TeamsTranscript_v1 | 会議または通話に対してトランスクリプトが有効になっている場合に、Teams の通話と会議からのトランスクリプトを提供します。 | データセットのTeamsTranscript_v1 |
組織階層
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| DirectReport_v0 | ユーザーのすべての直接レポートの詳細を提供します。 | データセットのDirectReport_v0 |
| Manager_v0 | マネージャーとして割り当てられたユーザーの一覧を提供します。 | データセットのManager_v0 |
タスク
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| TodoTaskFolders_v0 | ユーザー レベルの作業項目を追跡する Microsoft Outlook のタスク フォルダーを識別します。 | データセットのTodoTaskFolders_v0 |
| TodoTasks_v0 | ユーザー レベルの作業項目を追跡する Microsoft Outlook のタスクを識別します。 | データセットのTodoTasks_v0 |
| PlannerTasks_v0 | ユーザー レベルの作業項目を追跡する Planner のタスクを識別します。 | データセットのPlannerTasks_v0 |
User
| データセット名 | 説明 | 詳細情報 |
|---|---|---|
| User_v0 | 特定のテナント用に作成されたすべての Microsoft Entra ID (Azure AD) ユーザー アカウントに格納されているユーザーの詳細を提供します。 | データセットのUser_v0 |
| User_v1 | すべての Microsoft Entra ID (Azure AD) ユーザー アカウントに格納されているユーザーの詳細を提供します。 | データセットのUser_v1 |
OneDrive と SharePoint Online
| データセット名 | 説明 | サンプルとスキーマ |
|---|---|---|
| SharePointSites_v1 | SharePoint サイトに関する情報が含まれています。 以前はSharePointSitesDataset_v0_Previewと呼ばれます。 | SharePointSites_v1 |
| SharePointPermissions_v1 | 共有アクセス許可に関する情報が含まれています。 以前のDocumentSharingDataset_v0_Preview。 | SharePointPermissions_v1 |
| SharePointGroups_v1 | グループ メンバーに関する詳細を含む SharePoint グループ情報が含まれます。 以前のSharePointGroupsDataset_v0_Preview。 | SharePointGroups_v1 |
| SharePointFiles_v1 | SharePoint ファイルに関する情報が含まれています。 2024 年 8 月にリリース予定。 | SharePointFiles_v1 |
| SharePointFileActions_v1 | SharePoint ファイル アクションに関する情報が含まれています。 | SharePointFileActions_v1 |
| OneDriveSyncHealth_v1 | OneDrive for Business を実行しているデバイスに関する情報が含まれています。 | OneDriveSyncHealth_v1 |
Viva Insights
| データセット名 | 説明 | サンプルとスキーマ | ライセンス |
|---|---|---|---|
| VivaInsightsDataset_Report_v1_{Viva_Insights_Query_Name} | Viva Insights でユーザーが作成したクエリに従ったメトリックが含まれます。 | レポートごとに異なります。 | Viva Insights ライセンスが必要です。 |
注:
{Viva_Insights_Query_Name}は Viva Insights クエリ名のプレースホルダーを表し、VivaInsightsDataset_Report_v1_と組み合わせるとデータセット名が形成されます。
地域
データ接続は、さまざまな Microsoft 365 地域のデータ抽出をサポートします。 Microsoft 365 データ センターから Microsoft Azure ストレージにデータを正常に移動するには、Azure Synapse インスタンスまたは Azure Data Factory インスタンスと Azure ストレージの場所の両方が、Microsoft 365 データの場所でサポートされているリージョンにマップされている必要があります。
次の表は、サポートされている Microsoft 365 の領域と、データの移動に必要な対応する Azure リージョンを示しています。
| Office の地域 | Azure リージョン |
|---|---|
| アジア太平洋 |
|
| オーストラリア |
|
| ヨーロッパ |
|
| 北アメリカ |
|
| ブラジル |
|
| 英国 |
|
| カナダ (CAN) |
|
| 日本 (JPN) |
|
| インド (IND) |
|
| 韓国 (KOR) |
|
| スイス (CHE) |
|
| ドイツ (DEU) |
|
| ノルウェー (NOR) |
|
| フランス (FRA) |
|
| アラブ首長国連邦 (UAE) |
|
シンク
シンクは、Azure Synapse または Azure Data Factory が Azure ストレージにデータを配置するために使用する出力場所です。 Microsoft Graph Data Connect では、次のシンク ストレージの種類がサポートされています。
- Azure Data Lake Storage Gen2
- Azure Storage Blob
- Azure SQL DB (マッピング データ フローのみ)
- Microsoft Fabric OneLake
次の特徴をシンクに適用します。
サービス プリンシパル認証は、ソースとして Microsoft 365 を使用したコピー アクティビティで、すべてのシンク タイプに対してサポートされている唯一の認証メカニズムです。
シンクとして Azure Storage Blob を使用している場合、アプリケーションが Azure Storage Blob の場所への Storage Blob Data Contributor のアクセス権があることを確認する必要があります。
コピー アクティビティの場合、出力ファイルは JSON 形式になります。 この形式は固定されており、形式の変更はサポートされていません。 ただし、Azure Synapse または Azure Data Factory を使用して、Microsoft Graph Data Connect パイプラインの結果を別のストレージ メカニズム (Azure SQL Database など) にコピーできます。
マッピング データ フロー: Microsoft 365 (Office 365) からデータをコピーして変換する - Azure Data Factory & Azure Synapse |Microsoft Learn |
出力は Parquet 形式で指定できます。 サポートされているデータ変換の詳細については、「 マッピング データ フローでのフラット化変換」を参照してください。
マッピング データ フロー上の Microsoft Graph Data Connect では、Azure SQL DB へのデータの直接出力がサポートされています。
次の表は、対応するコピー アクティビティとマッピング データ フローでサポートされている領域を示しています。
| 分野 | コピー アクティビティ | データ フローのマッピング |
|---|---|---|
| サポートされている出力データ形式 | JSON | JSON、Parquet |
| データ変換 (正規化/フラット化など) | ADF/Synapse パイプラインに追加の変換ステップが必要 | インライン変換をサポート |
| サポートされているデータ シンク | ADLS gen2、Azure Blob | ADLS gen2、Azure Blob、Azure SQL DB |
| Azure VNET IR | 非サポート | サポート |