> ## 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.

# Azure Data Factory (ADF) を Insights に接続する

> レガシー PlayFab Insights に対して Azure Data Factory パイプラインを構築し、データ移動をオーケストレーションして、下流システム向けに大規模にゲーム イベント データを変換します。

# チュートリアル: Azure Data Factory (ADF) を Insights に接続する

このガイドは、Azure Data Factory (ADF) を Insights とともに使い始めるのに役立ちます。接続後、Azure Data Factory を使用して、データ移動をオーケストレーションし、大規模にゲーム データを変換するワークフローを作成できます。Insights に接続できる他のツールについては、[外部ツールを Insights に接続する](/services/playfab/data-analytics/legacy/connectivity) を参照してください。

このチュートリアルでは、次の方法について学びます:

<Note>
  \[!div class="checklist"] \* Azure でデータ ファクトリを作成する \* パイプラインを作成する
</Note>

<Note>
  PlayFab Insights Management は 2026/3/31 に廃止されました。今後のパフォーマンスとコストを管理するには、[Azure Data Explorer (ADX) Connections](/services/playfab/data-analytics/export-data/data-connection-adx) の使用をお勧めします。タイトルがまだ **Insights** を使用している場合は、実装の詳細についてこの記事を参照し続けてください。詳細については、[PlayFab Digest: 3 月の機能更新](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/) を参照してください。
</Note>

## 前提条件

### AAD で認証された PlayFab アカウント

認証プロバイダーが Microsoft に設定されている PlayFab アカウントまたはユーザーが必要です。Microsoft 認証プロバイダーは、Azure サービスの使用に必要な認証に Azure Active Directory (AAD) を使用します。AAD で認証されたアカウントまたはユーザーの作成手順については、[Game Manager 用の Azure Active Directory 認証](/services/playfab/identity/dev-identity/authentication/aad-authentication) を参照してください。

アカウントまたはユーザーが Microsoft 認証プロバイダーを使用するように設定されていることを確認するには:

* [developer.playfab.com](https://developer.playfab.com) に移動します。
* **\[Sign in with Microsoft]** を選択して PlayFab アカウントにアクセスします。

サインインできれば、そのアカウントは Microsoft 認証プロバイダーを使用するように設定されています。

### Insights の Game Manager 権限

アカウントに、次の Game Manager 権限が有効になっている [ユーザー ロール](/services/playfab/identity/dev-identity/permissions/playfab-user-roles) を割り当てる必要があります:

* 管理者ステータス。
* Explorer タブおよび関連データへのアクセス。
* Analytics データへの読み取りおよび書き込みアクセス。

新しいユーザー ロールを作成するか、既存のロールにこれらの権限を追加することができます。

### その他の前提条件

* [Azure Active Directory (AAD) アプリケーションを作成し、タイトル データベースに接続する](/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)

## 新しいデータ ファクトリの作成

新しいデータ ファクトリを作成するには:

1. [Azure Portal](https://portal.azure.com) にサインインします。ホームページの **\[Azure Services]** から **\[Create a resource]** を選択します。**\[Data Factory]** を検索して選択し、**\[Create]** を選択します。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-create-resource.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=16c50c669d45848a0d9b631456d9265b" alt="ADF リソースを作成" width="1179" height="692" data-path="images/playfab/data-analytics/legacy/connectivity/adf-create-resource.png" />
2. 必須フィールドを入力します:
   * **\[Name]** には、データ ファクトリの名前を選択します。名前は *グローバルに一意* である必要があります。
   * **\[Subscription]** で、データ ファクトリを作成する Azure サブスクリプションを選択します。
   * **\[Resource Group]** については、次のいずれかの手順を使用します:
     * **\[Use existing]** を選択し、リストから既存のリソース グループを選択します。
     * **\[Create new]** を選択し、リソース グループの名前を入力します。
   * GIT を今すぐ有効化する必要はないので、下のチェック ボックスをオフにします。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-new-data-factory.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=85a775cc184fc46853364491af635308" alt="ADF 新しいデータ ファクトリ" width="1184" height="692" data-path="images/playfab/data-analytics/legacy/connectivity/adf-new-data-factory.png" />
3. **\[Create]** を選択します。デプロイが完了したら、**\[Next steps]** で **\[Go to resource]** を選択します。
4. データ ファクトリの UI を別のタブで開くには、**\[Author & Monitor]** を選択します。

## パイプラインの作成

ここでは、Insights からデータを取得するための新しいパイプラインを作成します。パイプラインを作成するには:

1. **\[Let's get started]** ページで、**\[Create pipeline]** を選択します。
2. **\[Activities]** パネルの **\[Azure Data Explorer]** の下で、**Azure Data Explorer Command** を空のワークスペースにドラッグ アンド ドロップします。下部パネルの **\[General]** で、名前と説明を入力します。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-explorer-command.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=84f37a750818fe0401711b4e5ed073ea" alt="ADF Explorer Command" width="998" height="944" data-path="images/playfab/data-analytics/legacy/connectivity/adf-explorer-command.png" />
3. **\[Connection]** タブを選択し、**\[New]** を選択します。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-explorer-command-connection.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=bd25602c12c24f97f4f41f18b7753d9e" alt="ADF Explorer Command Connection" width="937" height="224" data-path="images/playfab/data-analytics/legacy/connectivity/adf-explorer-command-connection.png" />
4. **\[New linked service (Azure Data Explorer (Kusto))]** ウィンドウで、フィールドに入力します:
   * **\[Name]** には、Title ID を使用します。
   * **\[Account selection method]** で、**\[Enter manually]** を選択します。
   * **\[Endpoint]** には、PlayFab API エンドポイント (`https://insights.playfab.com`) を使用します。
   * **\[Service Principal ID]** に、Azure アプリのクライアント ID を入力します。
   * **\[Service Principal Key]** に、Azure アプリのクライアント シークレットを入力します。
   * **\[Database]** ボックスに、Title ID をすべて大文字で入力します。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-new-linked-service.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=c878805db8ac895e2230d4104e038532" alt="ADF 新しいリンク サービス" width="942" height="1273" data-path="images/playfab/data-analytics/legacy/connectivity/adf-new-linked-service.png" /> **\[Create]** を選択します。これでパイプラインの準備ができました。パイプライン名をクリックしてメイン パイプライン ビューに戻ることができます。
5. すべての情報が正しいことを確認するには、**\[Test connection]** を選択します。すべてが正しく設定されていれば、Connection successful (接続成功) の応答が返されます。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-test-connection.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=94738d63b129eefff8855a93807e3dea" alt="ADF 接続テスト" width="1315" height="241" data-path="images/playfab/data-analytics/legacy/connectivity/adf-test-connection.png" />
6. パイプラインを検証してデバッグするには、ワークスペースの上のツール バーで、**\[Validate]** を選択し、次に **\[Debug]** を選択します。

## 関連リソース

* [Azure Data Factory (ADF) ドキュメント](https://learn.microsoft.com/en-us/azure/data-factory/)
* Insights に接続する他のツールについては、[外部ツールを Insights に接続する](/services/playfab/data-analytics/legacy/connectivity) を参照してください。


## Related topics

- [Azure Data Explorer を Insights に接続する](/ja-jp/services/playfab/data-analytics/legacy/connectivity/connecting-azure-data-explorer-to-insights.md)
- [Python を Insights に接続する](/ja-jp/services/playfab/data-analytics/legacy/connectivity/connecting-python-to-insights.md)
- [Kusto C# SDK を Insights に接続する](/ja-jp/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-csharp-to-insights.md)
- [Grafana を Insights に接続する](/ja-jp/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)
- [Kusto Explorer を Insights に接続する](/ja-jp/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-explorer-to-insights.md)