​

教程：将 Azure Data Factory (ADF) 连接到 Insights

本指南可帮助你开始将 Azure Data Factory (ADF) 与 Insights 结合使用。连接后，你可以使用 Azure Data Factory 创建工作流，以大规模协调数据移动并转换游戏数据。要了解可与 Insights 连接的其他工具，请参阅将外部工具连接到 Insights。 在本教程中，你将学习如何：

​

先决条件

​

使用 AAD 认证的 PlayFab 账户

你需要一个 PlayFab 账户或用户，其身份验证提供商设置为 Microsoft。Microsoft 身份验证提供商使用 Azure Active Directory (AAD) 进行身份验证，这是使用 Azure 服务所必需的。有关创建 AAD 认证账户或用户的说明，请参阅 Game Manager 的 Azure Active Directory 身份验证。 要验证账户或用户是否设置为使用 Microsoft 身份验证提供商：

• 导航到 developer.playfab.com。
• 选择 Sign in with Microsoft 以访问你的 PlayFab 账户。

如果你可以登录，则该账户已设置为使用 Microsoft 身份验证提供商。

​

Insights 的 Game Manager 权限

你需要为你的账户分配启用以下 Game Manager 权限的用户角色：

• 管理员状态。
• 访问 Explorer 选项卡和关联数据。
• 对 Analytics 数据的读写访问。

你可以创建新的用户角色，也可以向现有角色添加这些权限。

​

其他先决条件

• 创建 Azure Active Directory (AAD) 应用程序并将其连接到你的标题数据库

​

创建新的数据工厂

要创建新的数据工厂：

1. 登录 Azure 门户。从主页的 Azure Services 下，选择 Create a resource。搜索 Data Factory，选择它，然后选择 Create。
2. 填写必填字段：
   • 对于 Name，为你的数据工厂选择一个名称。名称必须全球唯一。
   • 对于 Subscription，选择要在其中创建数据工厂的 Azure 订阅。
   • 对于 Resource Group，使用以下步骤之一：
     • 选择 Use existing，然后从列表中选择现有的资源组。
     • 选择 Create new，然后输入资源组的名称。
   • 你现在不需要启用 GIT，因此请取消选中下面的框。
3. 选择 Create。部署完成后，在 Next steps 下选择 Go to resource。
4. 要在单独的选项卡中打开 Data Factory UI，请选择 Author & Monitor。

​

创建管道

我们现在将创建一个新管道来从 Insights 获取数据。要创建管道：

1. 在 Let’s get started 页面上，选择 Create pipeline。
2. 在 Activities 面板 Azure Data Explorer 下，将 Azure Data Explorer Command 拖放到空白工作区中。在底部面板 General 下，填写名称和描述。
3. 选择 Connection 选项卡，然后选择 New。
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 应用的 Client ID。
   • 对于 Service Principal Key，输入你的 Azure 应用的 Client secret。
   • 在 Database 框中，输入全部大写的 Title ID。 选择 Create。现在管道已准备就绪。你可以通过单击管道名称返回主管道视图。
5. 要验证所有信息是否正确，请选择 Test connection。如果一切设置正确，将返回”连接成功”响应。
6. 要验证和调试管道，请在工作区上方的工具栏中，选择 Validate，然后选择 Debug。

​

其他资源

• Azure Data Factory (ADF) 文档
• 要了解连接到 Insights 的其他工具，请参阅将外部工具连接到 Insights