> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 に接続する](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/legacy/connectivity.md) を参照してください。

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

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

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

## 前提条件

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

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

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

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

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

### Insights の Game Manager 権限

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

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

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

### その他の前提条件

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

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

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

1. [Azure Portal](https://portal.azure.com) にサインインします。ホームページの **\[Azure Services]** から **\[Create a resource]** を選択します。**\[Data Factory]** を検索して選択し、**\[Create]** を選択します。 ![ADF リソースを作成](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)
2. 必須フィールドを入力します:
   * **\[Name]** には、データ ファクトリの名前を選択します。名前は *グローバルに一意* である必要があります。
   * **\[Subscription]** で、データ ファクトリを作成する Azure サブスクリプションを選択します。
   * **\[Resource Group]** については、次のいずれかの手順を使用します:
     * **\[Use existing]** を選択し、リストから既存のリソース グループを選択します。
     * **\[Create new]** を選択し、リソース グループの名前を入力します。
   * GIT を今すぐ有効化する必要はないので、下のチェック ボックスをオフにします。 ![ADF 新しいデータ ファクトリ](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)
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]** で、名前と説明を入力します。 ![ADF Explorer Command](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)
3. **\[Connection]** タブを選択し、**\[New]** を選択します。 ![ADF Explorer Command Connection](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)
4. **\[New linked service (Azure Data Explorer (Kusto))]** ウィンドウで、フィールドに入力します:
   * **\[Name]** には、タイトル IDを使用します。
   * **\[Account selection method]** で、**\[Enter manually]** を選択します。
   * **\[Endpoint]** には、PlayFab API エンドポイント (`https://insights.playfab.com`) を使用します。
   * **\[Service Principal ID]** に、Azure アプリのクライアント ID を入力します。
   * **\[Service Principal Key]** に、Azure アプリのクライアント シークレットを入力します。
   * **\[Database]** ボックスに、タイトル IDをすべて大文字で入力します。 ![ADF 新しいリンク サービス](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) **\[Create]** を選択します。これでパイプラインの準備ができました。パイプライン名をクリックしてメイン パイプライン ビューに戻ることができます。
5. すべての情報が正しいことを確認するには、**\[Test connection]** を選択します。すべてが正しく設定されていれば、Connection successful (接続成功) の応答が返されます。 ![ADF 接続テスト](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)
6. パイプラインを検証してデバッグするには、ワークスペースの上のツール バーで、**\[Validate]** を選択し、次に **\[Debug]** を選択します。

## 関連リソース

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


## Related topics

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