教程:将 Kusto Explorer 连接到 Insights
本指南可帮助你开始使用 Kusto 资源管理器和见解。 连接后,可以使用 Kusto 资源管理器查询和浏览游戏数据。 要深入了解可用于连接 Insights 的其他工具,请参阅 将外部工具连接到 Insights。
注意
PlayFab Insights 管理将从 2023 年 12 月 11 日起弃用。 我们建议使用 Azure 数据资源管理器 (ADX) 连接 来管理未来性能和成本。 如果你的游戏仍在使用 Insights,请继续查看本文以了解实现详细信息。 有关详细信息,请参阅 Insights 弃用博客。
先决条件
通过 AAD 进行身份验证的 PlayFab 帐户
需要一个身份验证提供程序设置为 Microsoft 的 PlayFab 帐户或用户。 Microsoft 身份验证提供程序使用 Azure Active Directory (AAD) 进行身份验证,这是使用 Azure 服务所必需的。 有关创建经过 AAD 身份验证的帐户或用户的说明,请参阅 Game Manager 的 Azure Active Directory 身份验证。
验证帐户或用户是否设置为使用 Microsoft 身份验证提供程序。
- 导航到 developer.playfab.com。
- 选择“使用 Microsoft 登录”以访问 PlayFab 帐户。
如果可以登录,则该帐户设置为使用 Microsoft 身份验证提供程序。
Insights 的 Game Manager 权限
需要向帐户分配已启用以下 Game Manager 权限的用户角色。
- 管理员状态。
- 访问资源管理器选项卡和关联的数据。
- 对分析数据进行读取和写入访问。
可创建新的用户角色或向现有角色添加这些权限。
其他先决条件
重要
Insights 仅支持 V1 查询响应架构。 可以使用以下步骤在 Kusto 资源管理器中更新响应架构。
在本地计算机上,打开 Kusto.Explorer。
选择“工具”选项卡,然后选择“选项...”
在“连接”类别下,更改以下两个属性。
- 将 查询结果协议 设置为从下拉列表选项 V1。
- 在下拉列表选项中将 KQL 分析器版本 设置为 V1。
使用 Kusto 资源管理器连接
在本地计算机上,打开 Kusto.Explorer。
添加连接。 可以通过两种不同的方式执行此操作:
- 选择"连接"选项卡,然后选择添加连接。
- 右键单击左侧导航面板中的 连接 文件夹,然后选择 添加连接。
在 添加连接 对话框中:
- 在 群集连接 输入 PlayFab API 终结点,该终结点 https://insights.playfab.com。
- 在 安全下,确保已选择 AAD 联合。
- 展开“高级: 连接字符串”框,并将“初始目录”的值从“NetDefaultDB”更改为
<titleID>
。 请注意,此处<titleID>
必须全部大写。 在下面的示例中,此更改在字符串中突出显示。
选择“确定”。 现在应该能够直观显示查询结果。