Data Explorer 功能处于公共预览阶段。我们预计在持续收集反馈
编写自定义查询
要开始在高级模式下编写自己的查询,首先了解你所访问数据的形态非常重要。events.all 表
events.all 表是所有传入事件的默认目标。它是一个单一的半结构化表,包含时间、事件名称等常见值的列。你会很快熟悉 EventData 列,它包含完整的原始 JSON 负载,几乎在所有查询中都很有用。你可以阅读关于 events.all 表的以下文档。
查询的结构
一个查询表达式通常以表名开头,后跟管道分隔符 (|)。 接下来是一个或多个运算符。每个运算符之间用管道分隔符分隔。 出于偏好,查询可以写在一行中,也可以在每个管道分隔符之前使用换行符。对查询本身没有影响。 查询窗格可以包含多个查询。这样便于从一个简单的表达式开始,验证它可以运行,然后再进行扩展。 一个空行将一个查询与另一个查询分开。你的光标位置决定按下”运行”按钮时运行哪个查询。你也可以突出显示查询的一部分,仅运行该部分表达式。构建你的第一个查询
现在让我们从头开始编写你的第一个查询。你可以在查询窗格中输入表名。但我们要使用一个小捷径。在资源窗格中找到events.all 表。你可能需要通过点击箭头来展开你的标题 ID 数据库。
找到 events.all 表后,双击表名。你会注意到此表达式已被添加到查询窗格中。
在预览版中,你需要手动添加表名周围的方括号和单引号。此不便之处的修复正在进行中。
player_logged_in 事件。找到后,向右按箭头到 EventData 列并双击。你现在应该看到:
你的查询可以使用点表示法 (.) 引用 EventData JSON 中的任何属性。你现在可以通过修改查询以仅返回单个玩家的 player_logged_in 事件来尝试。双击 EntityID GUID 并将其复制到剪贴板。
现在按如下所示更新你的查询并插入你复制的 GUID:
summarize 运算符。因为 summarize 不支持动态类型,我们还需要将 platform 转换为字符串。
示例查询
我们只是初步了解了 Explorer 中可以编写的查询类型。可以通过在 Explorer 页面上按”What’s This”加载更多示例查询。每个示例查询都是为了演示一些可用的各种运算符以及如何将它们应用于现实世界的问题。因为你的数据形态可能与我们的演示数据集不同,你可能需要修改示例查询以适应你的场景。
限制
有两个限制管理 Explorer 查询的使用:- 最大查询运行时间:单个查询不允许运行超过 30 秒。如果超过此限制,查询将被终止,你将收到错误消息。
- 时段用量:每个标题在任何给定的 10 分钟时段内允许累计运行三分钟。如果超过此限制,你将收到错误消息,并且需要等待才能运行其他查询。
