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

# Data Explorer 基本模式入门

> 使用 PlayFab Data Explorer 基本模式无需代码即可构建事件查询，将条件和子句组合起来以探索玩家事件和分析。

<Info>
  Data Explorer 功能处于公共预览阶段。我们预计在持续收集反馈
</Info>

并针对客户使用情况进行优化的过程中，会对其进行持续变更。

Data Explorer 基本模式旨在让你快速发现事件数据中的洞察，而无需了解查询语言。这种非技术性的查询构建体验使用户能够快速探索他们的数据。要学习如何编写更复杂的查询，请参阅 [Data Explorer（高级）入门](/services/playfab/data-analytics/learn-data/data-explorer/getting-started-with-data-explorer-advanced)教程。

## 编写自定义查询

要开始在基本模式下编写自己的查询，首先了解你所访问数据的形态非常重要。

### events.all 表

`events.all` 表是所有传入事件的默认目标。它是一个单一的半结构化表，包含时间、事件名称等常见值的列。你会很快熟悉 EventData 列，它包含完整的原始 JSON 负载，几乎在所有查询中都很有用。你可以阅读关于 [events.all 表](/services/playfab/data-analytics/acting-data/schemas-events-all)的以下文档。

### 查询

一个查询由一个或多个通过 'OR' 逻辑运算符组合的\*\*条件（Conditions）**组成。一个条件由 event.all 表中的一个**事件（Event）\*\*组成。

可以通过向条件添加一个或多个**子句（Clauses）**来创建复杂条件，子句是由**变量（Variable）**、\*\*运算符（Operator）**和**值（Value）\*\*组成的逻辑语句。子句通过 'AND' 逻辑运算符组合。下拉列表中列出的变量根据创建条件时所选的事件填充。

可以通过修改\*\*开始日期（Start date）**和**结束日期（End date）\*\*来调整查询的时间范围。

可以通过添加 **Group By** 和 **Aggregate Type** 来进一步修改查询的输出。Group By 修改输出行的分组方式，而 Aggregate Type 修改行的计数、求和或去重方式。

你可以在查询面板中创建查询。请注意，Data Explorer（基本）查询将仅引用前 100 个事件。要查看所有事件，请在 [Data Explorer（高级）](/services/playfab/data-analytics/learn-data/data-explorer/getting-started-with-data-explorer-advanced)中运行查询。

## 查询输出

运行查询后，可以在下方的查询输出面板中看到输出。输出以柱状图和表格的形式呈现。

图表显示最大的五个分组的结果。你可以通过点击图表底部的下拉列表查看其他分组。

表格显示每一行的事件名称、时间戳 (UTC)、玩家 ID 和事件数据（通过 JSON）。

## 示例查询

### 单条件查询

#### 本周玩家从哪些区域登录？

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_1.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=1d3d2ac0bdbe5836d5cabb6ff6ac4bb0" alt="本周按区域划分的玩家登录" width="638" height="552" data-path="images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_1.png" />

#### 本周玩家从哪些设备登录？

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_2.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=c3f7e3d581d6e32f46cbb27e926a0c85" alt="本周按设备划分的玩家登录" width="638" height="522" data-path="images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_2.png" />

#### 本周订单总额的总和是多少？

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_3.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=dd04e21de53c2cdb0d6a76ca1e2da8c7" alt="本周订单总额之和" width="638" height="448" data-path="images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_3.png" />

#### PlayFab 限制是否已被超过？

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_4.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=a01177c5c9ed08bef16ddf36bb885d7d" alt="本周超过标题限制" width="638" height="522" data-path="images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_4.png" />

### 多条件查询

#### 本周哪些玩家和实体正在登录？

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_5.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=b3ac1b0d2c1061a4db286b4d629d6091" alt="本周玩家或实体登录" width="638" height="636" data-path="images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_5.png" />

#### 本周哪些物品正在被购买或添加到库存中？

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_6.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=d33116ecd73b456d6186f3a45eb057fd" alt="本周物品被购买或添加" width="638" height="636" data-path="images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_6.png" />

### 带子句的复杂条件查询

#### 本周购买了多少"剑"类物品？

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_7.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=784f9f4b3d0c79f9add867e5f410eb95" alt="本周购买剑类物品" width="638" height="652" data-path="images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_7.png" />

#### 本周购买了多少价值在 $1 到 $5 之间的物品？

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_8.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=8c1e2d5f082fa87533565c5c237dbb40" alt="本周购买价值范围内的物品" width="940" height="664" data-path="images/playfab/data-analytics/learn-data/data-explorer/ExplorerBasic_Query_8.png" />

可以通过选择"What's This"并选择一个示例查询将示例查询加载到 Data Explorer 基本模式中。

## 限制

有两个限制管理 Data Explorer 查询的使用：

1. 最大查询运行时间：单个查询不允许运行超过 30 秒。如果超过此限制，查询将被终止，你将收到错误消息。

2. 时段用量：每个标题在任何给定的 10 分钟时段内允许累计运行三分钟。如果超过此限制，你将收到错误消息，并且需要等待才能运行其他查询。

## 数据保留

默认情况下，Explorer 查询运行在热存储上，可以在管理工具中进行配置。搜索超出热存储中所存数据的查询运行时间将显著变长，并可能超时。
