次の方法で共有

Microsoft Graph データ接続についてよく寄せられる質問

  • [アーティクル]

Microsoft Graph データ接続を使用すると、開発者は、顧客が Microsoft Graph の膨大なデータセットへのマネージド アクセスを提供するために使用できるアプリケーションを開発できます。 この記事では、Microsoft Graph Data Connect 機能を活用するのに役立つヒントを提供します。 Microsoft Graph データ接続の概要については、「概要」を参照してください。

その他の質問については、「 トラブルシューティング 」を参照するか、次の項目を選択して新しい Azure サポート 要求を作成します。

  • サービスの種類: Microsoft Graph High-Capacity API を選択する
  • 問題の種類: Microsoft Graph Data Connect (MGDC) を選択する

Microsoft Graph Data Connect の問題を参照するための Azure サポート要求のトピックの選択を示すスクリーンショット。

Microsoft Graph データ接続は適切な選択ですか?

Microsoft Graph Data Connect と Microsoft Graph API は、同じ基になるデータへのアクセスを提供しますが、非常に異なる方法でアクセスできます。 Microsoft Graph Data Connect は、組織全体にスケーラブルな大量のデータセットを一括で抽出するように設計されています。Microsoft Graph API は、組織内の選択したユーザーとグループから少量のデータにアクセスするのに適しています。

たとえば、Microsoft Graph Data Connect を使用して、過去 1 年間のメール データの最初の抽出を行い、次に Microsoft Graph API を使用して電子メールをリアルタイムで分析することができます。 Microsoft Graph Data Connect と Microsoft Graph API は、ジョブごとに異なるツールです。 実現したいシナリオに最適なアクセス方法はどちらかを検討することが大切です。 詳細については、「 Microsoft Graph API または Microsoft Graph Data Connect を使用する必要がある場合」を参照してください。

企業が Microsoft 365 データを使用するシナリオは何ですか?

Microsoft 365 データを利用できるユース ケースはいくつでも存在します。 顧客が関心を持つ一般的なシナリオを次に示します。

  • Customer Relationship Analytics: コマーシャル ビジネス リーダーの場合は、従来の CRM 分析情報を超えて、コミュニケーションとコラボレーション パターンに基づいて顧客の相互作用と関係を理解します。

  • Business Process Analytics: 運用を向上させるには、日常的に組織を通じて実際に作業がどのように流れるかを参照してください。 自動化または最適化する必要がある手動のプロセスとワークフローのボトルネックを特定します。

  • セキュリティとコンプライアンス分析: 機密データをセキュリティで保護するには、従業員がどのように機密情報を使用して共有しているかを学習します。 異常検出、脅威インテリジェンス、監査ログ分析、リスク管理、法的フォレンジックを実装します。

  • People Productivity Analytics: 変革を推進するために、Viva の生産性メトリックをエクスポートして、デジタル導入、スマート会議とコンテンツ、ハイブリッド ワークプレース、文化的変化を伴うソリューションに分析情報を変換できるようにします。

Viva Insights と Microsoft Graph Data Connect の違い  

Viva Insights と Microsoft Graph Data Connect は補完的です。 どちらも Microsoft 365 に依存していますが、Viva Insights と Data Connect はさまざまな対象ユーザーとニーズに対応します。

お客様が Viva Insights 以外の分析情報と分析を求めている場合、Data Connect はカスタム要件を提供するための拡張性を提供します。 たとえば、Teams の通話レコードとトランスクリプトのほか、現在 Viva Insights のスコープに含まれていない SharePoint Online データ セットが提供されます。 さらに、Data Connect の生データは、Viva Insights から入手できない詳細を提供します。

Microsoft Graph Data Connect の初期オーバーヘッドはありますか?

データ接続は大量のデータを一括して抽出するように設計されているため、データを抽出できるようになる前に、ある程度のオーバーヘッドが発生します。 このオーバーヘッドは約 45 分です。つまり、データ サイズに関わりなくすべてのパイプラインで、その程度の時間が最低必要になります。 ユース ケースに対して初期オーバーヘッドが長すぎる場合は、前のセクションで説明した詳細を含む新しい Azure サポート 要求を作成してください。

Microsoft Graph Data Connect はどのリージョンで利用できますか?

現在、Microsoft Graph Data Connect は、北米、ヨーロッパ、アジア太平洋、英国/英国、オーストラリアの複数のリージョンで利用できます。 その他のリージョンは、今後利用可能になる予定です。

Office から Azure へのリージョンとマッピングの一覧については、「 データセット、リージョン、シンク」を参照してください。

Microsoft Graph Data Connect で使用できるデータセットは何ですか?

次の種類のデータセットを使用できます。

  • 基本: 生の顧客が作成したコンテンツと、Microsoft 365 アプリケーションとサービスからの入力 (Microsoft Entra ID、Outlook、Teams データセットなど) から生成されたデータセット。 

  • クリーン済み: 基本的なデータセットからの正規化と重複除去によって生成されたデータセット、または Microsoft 365 のユーザー アクティビティまたは動作シグナル (SharePoint、Office 365 データセットなど) から作成されたデータセット。  

  • キュレーション: 特定のユース ケースまたは分析シナリオ用にカスタム生成されたデータセット、または機能拡張のためにファースト パーティの Microsoft 365 分析アプリケーションのデータセット (Viva Insights メトリックなど)。

次の各データセットを複数使用できます。

  • Teams
  • Outlook
  • Microsoft Entra ID
  • OneDrive/Sharepoint
  • Viva Insights

新しいデータセットは、Microsoft Graph Data Connect に定期的に追加されます。 完全な一覧については、「 データセット、リージョン、シンク」を参照してください。

プレビュー段階のデータセットと一般公開されているデータセットはどれですか?

一般公開またはプレビューのみのデータセットについては、「 データセット、リージョン、シンク」を参照してください。

課金はどのように計算されますか?

Microsoft Graph Data Connect では、お客様に月単位で課金され、請求書の計算時に端数切り上げも行われます。 各パイプライン実行は個別に課金されます。

たとえば、顧客は月内に 20 個のパイプライン実行を行い、それぞれ 500 行を生成します。 合計で、顧客はその月に 10,000 行のパイプラインを実行します。 ただし、請求額は 10,000 行/1000 行 = 10 単位ではありません。

代わりに、Microsoft Graph Data Connect は分数を切り上げるため、顧客は 20 単位に対して課金されます。 500 行/1000 行 = 0.5 および 0.5 は分数であるため、1 に切り上げられます。 顧客にはパイプライン実行ごとに 1 つのユニットが課金され、合計で 20 ユニットが課金されます。

テナントでデータセットがまだサポートされていない場合、どうすればよいですか?

プレビュー データセットの場合は、「 データセット、リージョン、シンク」で説明されている条件を満たしていることを確認します。 これらのデータセットは、明示的にオプトインした顧客のみが使用できます。

質問については、前のセクションで説明した詳細を含む新しい Azure サポート 要求を作成します。

Microsoft Graph Data Connect が最適なシナリオは何ですか?

生産性ツールに提供される大規模なデータセットを活用できる組織は、直面する可能性のある課題と機会に関する多くの分析情報を入手できます。 お客様は、ユーザーの生産性分析のための組織ネットワーク、セキュリティとコンプライアンス分析のための情報の過剰共有、顧客関係分析の販売者関係の強みなど、複数のシナリオにわたってアプリケーションを構築します。

データが Microsoft Graph データ接続の組織のサブスクリプション内にとどまる可能性はありますか?

Microsoft Graph Data Connect は、要求されたデータセットを配信するときに、組織のテナント境界を尊重します。 Microsoft 365 データセットにアクセスするには、Azure リソースと Microsoft 365 サービスの両方が同じ Microsoft Entra テナント内に配置されている必要があります。 クロステナント データセット アクセスは現在使用できません。

Microsoft Graph データ接続にはサービス プリンシパルが必要ですか?

Azure Synapse または Data Factory パイプラインを作成するときは、Microsoft 365 のリンクされたサービスにサービス プリンシパルを指定する必要があります。 Azure では、サービス プリンシパルは、アプリケーションまたはサービス (つまり、ユーザーではない) を表すセキュリティ ID です。 Microsoft Graph データ接続は、Microsoft 365 データへの承認されたアクセスを取得する際に、その ID としてサービス プリンシパルを使用します。

他のユーザーが自分のテナントで使用できる Azure 管理対象アプリを作成する場合も、そのアプリが使用するサービス プリンシパルをアプリの発行元が提供します。 このサービス プリンシパルは、発行元のテナント内にあります。 ただし、アプリで他のサービス プリンシパルが必要になる場合は、インストールしたユーザーが自分のテナント内にサービス プリンシパルを作成します。 たとえば、Azure Synapse または Azure Data Factory パイプラインでは、Azure 内のストレージ リソースへのアクセスが必要になる可能性があります。 お客様は、パイプラインが使用するストレージ アカウントへのアクセス許可を指定したサービス プリンシパルを作成します。

Azure Synapse または Azure Data Factory を使用してアプリケーションをビルドする方法の詳細については、「 Data Connect のクイック スタート」を参照してください。

抽出されるデータのスコープがデータセット、列、ユーザー、シンクに対して同じままである限り、パイプラインの実行には新しい同意要求は必要ありません。 代わりに、パイプラインは承認済みのアクティブな同意を使用します。 異なる日付に対して同じスコープでパイプラインを実行しても、新しい同意は必要ありません。

必要に応じて重複するメールを削除することはできますか?

Message データセットからメールを抽出する際に、同じメールの JSON オブジェクトが複数存在することがよくあります。 これらの重複は、メールが複数のユーザーに送信されると、すべての受信者のメールボックスにメールのコピーがあるために存在します。 データセットは各メールボックスから抽出されるため、全ユーザーのコピーがすべて含まれることになります。 一部のシナリオではコピーをすべて保持する必要がありますが、そうでなければ、重複を削除できます。

エクスポートされた JSON オブジェクトの重複は、メッセージの internetMessageId に基づいて削除できます。同じ internetMessageId を持つ 2 つのメッセージは、同一インスタンスの重複するコピーです。 重複は異なる BLOB に存在することもあるので、BLOB ごとに重複を削除するのではなく、すべての BLOB を対象に重複を削除する必要があります。

puser フィールドを使用して関連するユーザーを特定することはできますか?

抽出したデータには、対応する Microsoft Graph API を使用する時点では存在しないメタ プロパティがいくつか含まれます。 特に puser フィールドは、データの抽出元ユーザーを特定するのに役立ちます。 同じメールのコピー 2 つが異なるメールボックスにあるシナリオでは、puser フィールドを使用することで、どちらのコピーがどのメールボックスから抽出されたかを特定できます。 puser フィールドは、Manager データセットなどのデータセットにも役立ちます。 エクスポートされた JSON にはマネージャーに関する情報が含まれますが、この情報が役立つのはそのマネージャーが誰のマネージャーであるかを知っている場合に限られます。 puser フィールドから、その JSON オブジェクトが一致するのは誰のマネージャーであるかを確認できます。

ハイブリッド モードのテナント設定はサポートされていますか?

Microsoft 365 のセットアップで Exchange Online に一部のユーザーがいて、Exchange オンプレミスに一部のユーザーがいる場合、Exchange オンプレミスにいるユーザーはサポートされません。 残念ながら、Data Connect は現在、Exchange オンプレミス ユーザーではサポートされていません。

リソース アカウントはサポートされていますか?

現在、リソース アカウントからのメッセージまたはイベントへのアクセスはサポートされていません。

ADF パイプラインの実行ごとに複数のファイルが表示され場合と、実行ごとに 1 つのファイルのみが表示される場合があるのはなぜですか?

Microsoft Graph データ接続は、パイプラインの実行ごとにユーザー リストを取得し、データセットの抽出とキュレーションを、並行して実行される複数のジョブに分散します。 並列実行ごとに、ユーザーが定義したデータ シンクに 1 つの出力ファイルが生成されます。 場合によっては、ユーザー リストが小さい場合、それらは 1 つの抽出およびキュレーション ジョブにマップされることがあり、その場合、データ シンクに生成される出力ファイルは 1 つだけです。