> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlayFab と Microsoft Fabric リアルタイム分析チュートリアル

> PlayFab を Microsoft Fabric リアルタイム分析と統合し、ゲーム イベントをストリーミングして Power BI ダッシュボードで KPI を探索するためのエンドツーエンド チュートリアル。

このチュートリアルでは、**PlayFab** と **Fabric リアルタイム分析** を統合してゲームのリアルタイム分析とインサイトを有効化する方法をエンドツーエンドで説明します。ステップ バイ ステップの手順に従うことで、PlayFab の Data Connections サービスを使用してゲーム イベントを Fabric リアルタイム分析データベースに配信する方法と、Fabric Power BI ダッシュボードにアクセスして主要ゲーム KPI を探索する方法を学べます。このチュートリアルには、サンプルの Power BI ダッシュボードと、統合を完了するために必要なすべてのリソースが含まれています。

<iframe src="https://www.youtube.com/embed/lbHjRRz7i1I" width="100%" height="400" allowFullScreen frameBorder="0" />

### 前提条件

* このチュートリアルを正常に完了するには、Microsoft Fabric が有効化された [キャパシティ](https://learn.microsoft.com/en-us/fabric/enterprise/licenses#capacity) が必要です。期間限定で、[Microsoft Fabric (プレビュー) トライアルにサインアップ](https://learn.microsoft.com/en-us/fabric/get-started/fabric-trial) できます。
* PlayFab 開発者アカウント。[playfab.com](https://developer.playfab.com) でサインアップしてください。
* Microsoft PowerBI Desktop がインストールされていること。[Get started with Power BI Desktop](https://learn.microsoft.com/en-us/power-bi/fundamentals/desktop-getting-started#install-and-run-power-bi-desktop) を参照してください。

## Fabric ワークスペースの作成

1. [Microsoft Fabric](https://msit.powerbi.com/home) に移動します。
2. 左側のナビゲーション バーで、**\[Workspaces]** > **\[New workspace]** を選択します。
3. 画面の右側にペインが開きます。
4. ワークスペースの名前を入力します。必須フィールドは **\[Name]** のみです。例: **PlayFabReports**。

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/create-workspace-fabric.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=2db6e2c3e95dfe7e0e5d2c3d76ac8c95" alt="Microsoft Fabric ワークスペースの作成" width="373" height="330" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/create-workspace-fabric.png" />

5. **\[Apply]** を選択してワークスペースを保存します。

詳細については、[Create a workspace - Microsoft Fabric | Microsoft Learn](https://learn.microsoft.com/en-us/fabric/get-started/create-workspaces) を参照してください。

## KQL データベースの作成

ワークスペースをセットアップしたら、次のステップは、すべての PlayFab イベントの流入先となる KQL データベースを作成することです。

1. [Microsoft Fabric](https://msit.powerbi.com/home) に移動します。
2. 左側のナビゲーション バーで、**\[Workspaces]** > **\[Your Workspace]** を選択します。
3. **\[New]** > **\[More Options]** > **\[KQL Database]** を選択します。
4. **\[KQL Database name]** フィールドに名前を入力し、**\[Type]** として **\[New database]** を選択します。

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/new-kql-database.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=6207df09d76e50a47782669517a64875" alt="KQL データベースの作成" width="336" height="263" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/new-kql-database.png" />

5. **\[Create]** を選択してデータベースの作成を完了します。

詳細については、[Real-time analytics - Create resources](https://learn.microsoft.com/en-us/fabric/real-time-analytics/tutorial-1-resources) を参照してください。

## Microsoft Fabric データ接続の作成

KQL データベースを作成すると、次のスクリーンショットに示すようにワークスペースに表示されます。

次に、すべてのイベントが KQL データベースに流入するように、データ接続を作成します。

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/kql-database-overview.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=afd45271058fdd90abad4118af3c65db" alt="KQL データベースの概要" width="624" height="261" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/kql-database-overview.png" />

1. [Microsoft Fabric](https://msit.powerbi.com/home) に移動します。
2. 左側のパネルで **\[Workspaces]** を選択し、**\[Your Workspace]** を選択します。
3. **\[Query URI]** ラベルの隣にある **\[Copy]** アイコンを選択して、**Query URI** をコピーします。
4. **PlayFab** に移動し、[Game Manager](https://developer.playfab.com/) にサインインします。
5. 左側のメニューから **\[Data]** を選択します。
6. **\[Data Connections]** タブを選択します。
7. **\[New connection]** ボタンを選択します。
8. **\[Destination type]** ドロップダウンで、**\[Fabric KQL Database]** オプションを選択します。
9. **\[Name]** フィールドで **データ接続** に名前を付けます。
10. **\[Enabled]** ボックスがチェックされていることを確認します。
11. Fabric から取得した **Query URI** を **\[Ingestion URI]** フィールドに貼り付けます。
12. **\[Database]** フィールドに、Fabric で作成した **KQL データベース** の名前を入力します。
13. **\[Table]** フィールドに意味のある名前を入力します。例: **Events**。

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/new-data-connection.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=2357a5b6c38a42d5d5d08afd9d78d6a6" alt="新しいデータ接続" width="1366" height="960" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/new-data-connection.png" />

ページの下部にクエリのセットがあります。次のセクションでは、これらのクエリを Fabric にコピーしましょう。

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/kql-queries.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=fe0de34e6152fb97dc31f87ae15a7b11" alt="KQL クエリ" width="1616" height="234" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/kql-queries.png" />

## すべてを組み合わせる

1. **Fabric** の **KQL データベース** ページに戻ります。
2. **\[Explore your data]** を選択します。
3. 各クエリを 1 つずつコピーして、ペインの上部にある **\[Run]** ボタンを選択して実行します。
4. 結果は次のようになります:

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/kql-queries-result.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=ed4740a356a91fc72cb62a713f6cc803" alt="KQL クエリの結果" width="624" height="541" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/kql-queries-result.png" />

5. **Game Manager** の **\[Data Connections]** タブに戻ります。
6. **\[Save]** を選択します。

## 実際の動作を確認する

最高の結果を得るには、上記のすべての手順を完了した後、次の手順を実行します。

デモの目的で、PlayFab の Game Manager でいくつかの新しいプレイヤーを作成しましょう。その後、Power BI レポートでそれらのデータを確認できるようになります。

### Game Manager でプレイヤーを作成する

1. **PlayFab** に移動し、[Game Manager](https://developer.playfab.com/) にサインインします。
2. 左側のメニューから **\[Players]** を選択します。
3. **\[Players]** タブを選択します。
4. **\[New player]** を選択します。
5. **\[Create and login player]** を選択します。
6. これらの手順を繰り返して、必要な数のプレイヤーを作成できます!

### PlayFab の Power BI テンプレートを Microsoft Fabric にアップロードする

このプロセスには 2 つのステップがあります。まず、PlayFab の Power BI テンプレートをダウンロードし、次に Microsoft Fabric にアップロードします。

#### GitHub から Power BI テンプレートをダウンロードする

1. [GitHub](https://github.com/) に移動してサインインします。
2. [PlayFabPowerBITemplates](https://github.com/PlayFab/PlayFabPowerBITemplates) リポジトリに移動します。
3. ページの右上にある **3 点ボタン** を選択してテンプレートをダウンロードします。

#### Power BI Desktop でテンプレートを開き、Microsoft Fabric にパブリッシュする

1. **PowerBI Desktop** を開きます。
2. 画面上部の **\[File]** タブを選択します。
3. 画面左下の **\[Browse this device]** を選択します。
4. ダウンロードしたテンプレート ファイル (.pbit) を探して **選択** し、**開き** ます。

<Tip>
  ダウンロードしたテンプレートを探すときは、既定で *.pbix ファイルが表示されるため、ドロップダウンでファイル タイプを \[Power BI テンプレート ファイル (*.pbit)] に更新してください。
</Tip>

5. **\[PlayfabReportTemplate]** ウィンドウで接続パラメーターを入力します。
   * [Microsoft Fabric](https://msit.powerbi.com/home) に移動します。
   * 左側のパネルで **\[Workspaces]** を選択し、ワークスペースを選択します。
   * URI: URI フィールドの隣にある **\[Copy]** アイコンを選択して Query URI をコピーします。
   * Database: **\[Database]** フィールドに、Fabric で作成した KQL データベースの名前を入力します。
   * **\[Table]** に、[Microsoft Fabric データ接続の作成](#create-a-microsoft-fabric-data-connection) で作成したテーブル名を入力します。上記の例の名前を使用した場合は、**Events** です。
6. **\[Load]** を選択します。
7. ページ上部の **\[Publish]** を選択します。
8. **\[Save]** を選択します。
9. **\[Save]** ファイル フォームに入力します (以前にファイルを保存していない場合のみ)。
   * レポートに自分にとって意味のある **名前** を付けます。例: **OverviewReport**
   * 保存する **場所** を選択します。
   * **\[Save]** を選択します。
10. **\[Microsoft Fabric ワークスペース]** を選択して **\[Publish]** フォームに入力します。
11. **\[Open OverviewReport.pbit in Power BI]** リンクを選択します。これにより、Fabric でテンプレート レポートが開きます。

これらの手順を完了したら、Fabric でワークスペースを選択して、データベースとレポートのリストを確認します。

<Info>
  表示されるデータの量は、データ接続がいつ作成されたかに依存します。PlayFab はデータをバックフィルしません。
</Info>

## 関連項目

* [Microsoft Fabric の用語](https://learn.microsoft.com/en-us/fabric/get-started/fabric-terminology)
* [ワークスペースの作成](https://learn.microsoft.com/en-us/fabric/get-started/create-workspaces)
* [Microsoft Fabric ホームページからアイテムに移動する](https://learn.microsoft.com/en-us/fabric/get-started/fabric-home)
* [Microsoft Fabric のエンドツーエンド チュートリアル](https://learn.microsoft.com/en-us/fabric/get-started/end-to-end-tutorials)


## Related topics

- [リアルタイム分析の中核概念](/ja-jp/services/playfab/data-analytics/ingest-data/real-time-analytics-core-concepts.md)
- [Lobby and Matchmaking のリアルタイム メッセージ](/ja-jp/services/playfab/multiplayer/lobby/lobby-and-matchmaking-real-time-messages.md)
- [チュートリアル プレイヤープロファイルの取得](/ja-jp/services/playfab/player-progression/player-data/getting-player-profiles.md)
- [Game Saves のチュートリアルとサンプル](/ja-jp/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md)
- [イベントパイプラインチュートリアル](/ja-jp/services/playfab/sdks/c/event-pipeline/eventpipeline-tutorial.md)
