版本：2.13.0

高阶查询

进入查询页面之后，默认就进入了“高阶查询”页面。 search_page_overview

炎凰数据平台的高阶查询页面提供一系列的相关功能，可以满足用户通过输入SQL语句完成交互式查询分析。并且可以将SQL查询结果固化为仪表板当中的图表。

功能组件

查询输入框

search_bar_overview

时间范围选择器

炎凰数据平台提供丰富的时间范围样式供用户选择，具体请看关于时间范围选择器的相关文档

trp_overview

查询模式

在查询页面中，默认的查询模式为完整查询模式。可以点击完整查询按钮来进行切换。
- 完整模式：完整查询结果，包含查询结果，字段详情以及时间直方图。
- 快速模式：仅包含查询结果，适用于需要快速获得结果时使用。

查询内容

点击查询按钮之后，等待后台解析、计算后获取最终的查询内容。查询内容包括三部分，分别为查询结果、可视化、原始数据。

信息

如果查询语句中不包含任何聚合函数，那么此时原始数据与查询结果数据将会保持一致。

search_content

查询结果

返回查询语句的最终结果。

search_result_content

当查询结果数量超过300条时，将会自动开启滑动条。

search_result_with_datazoom

原始结果

返回查询语句中第一次聚合运算之前的投影结果，返回字段包含 _time 和 _message 以及聚合中涉及到的字段（注：count(*) 只返回 _time 和 _message）

search_row_event_content

查询历史

在查询页面中，点击查询语句历史左侧按钮，可以查看最近使用过的十条查询语句。点击加载查询语句按钮，即可将该查询输入到查询框中。
对于过长的查询语句，可以点击最右“更多”按钮，查看完整的语句。
对于格式化过的查询语句，也可点击最右“原格式”按钮，查看原始格式化过的语句。

在查询框中输入的内容如果部分匹配查询语句的历史，则会弹出提示框，在提示框中选中的查询将直接输入查询框。

时间直方图

查询返回数据集的统计结果会以直方图的方式展示，x轴为选定的时间范围，y轴为指定时间间隔内事件的条数。

histogram

直方图时间粒度以及缩放

默认情况下，直方图的时间粒度是自动计算的，可以根据需要调整为秒，分，时，日，月，年。调整完成后会重新触发查询，用新的粒度进行结果集的统计计算。

histogram_zoom

除了粒度的调整，还可以对查询范围进行调整。

放大查询范围

点击放大查询范围会根据当前选择的时间范围计算，依次放大到当前分钟，当前小时，当天，当月，当年，当前10年，当前20年，所有时间。

缩放到选择范围

点击缩放到选择范围按钮后，会激活鼠标在直方图上的选取功能，当确定选取范围后，会根据新选择的范围重新触发查询。

查询结果导出

可将查询结果集导出到本地文件，目前支持json和csv格式。 search_result_export

默认情况下，会将所有结果集导出到一个文件。

search_result_export_modal_all

或者，选择部分结果集导出，输入预期导出的结果集条数以及起始位置。

search_result_export_modal_partial

导出时，还可以指定过滤掉一些字段。 search_result_export_modal_filtered_fields

查询结果表格

查询结果返回之后，系统会将结果展示在事件页面的下方。根据不同的搜索结果，系统会自动用不同的方式来进行展示

一般查询结果

对于大多数的查询结果，系统会以一个表格的形式进行展示，因为SQL语句的所有返回都是一个表格，如图所示：

stats_result

在表格的左边，系统将结果集的所有的列显示为一个列表。列表的每一项都有2种状态：选中或未选中。用户可以自己选择是否要暂时的显示或隐藏某一列。

事件查询结果

对于select * from <EventSet_Name> 这种类型的查询，系统会返回符合搜索条件的所有事件，以及事件的所有字段。而对于这种搜索结果展示，会使用一种适用于事件展示的查询结果表格来展示 event_result

查询结果展示配置

针对不同的查询结果，用户可以自行配置查询结果的表格的展示效果，点击表格上方的“展示配置”按钮，即可进行相应配置。 result_table_display_options

默认情况下，查询结果表格每行高度是自适应的。如果觉得部分查询事件过长，可选择“自定义”并输入每行结果的最大行数。 result_table_display_custom_rows

对于超过最大行数的查询事件，省略部分会以...形式展示，如果需要查看完整事件，可将鼠标移至该事件并点击🔽按钮 expand_table_event 同时，也可点击🔼按钮收起被展开的完整事件 collapse_table_event

事件上下文

针对每条事件，可以点击事件旁+号按钮展开显示该事件对应的所有字段值。

同时，针对select * from <EventSet_Name> 这种类型的查询，在展开的表单项，可以点击事件操作——查看事件上下文来查看单个事件所对应的日志上下文。 event_detail

点击事件上下文按钮，可以在打开页面中看到所选事件（高亮显示）的对应上下文信息。 event_context

在表格的左边，系统将所有事件的字段分为两个列表，而当用户选择某些字段时，系统会将这些字段显示在已选字段中。

用户可以点击任意字段，查看字段的详细内容或者选择显示该字段值。同时，点击任意字段值，会将该值加入到查询过滤。

field_detail

该字段列表默认情况下只会显示最多20个字段，如果用户需要查看所有字段，可以点击最下方的查看所有字段来进入字段选择界面。 field_selector

对于字段选择界面，用户可以看到基于该查询结果所抽取的所有字段。 ![all_field_selector](./assets/yhp/all_field_selector.png)

用户可以点击事件左边的+来展开事件。
展开后，系统会将这条事件的所有字段以及字段的值，作为一个列表展示在该事件下方，方便用户详细的查看。
展开后，用户也可以点击字段值，将其加入到查询过滤。

分页展示

当结果集的数量大于一定限制时（默认为20条），系统会优先展示第一页，而右上角的页码则会告诉用户正在显示结果集中的部分结果，如图所示：

result_pagination

用户可以点击页码翻页，或者可以调整右边的每页显示条数，来增加或者减少每页的显示数量。

查询过滤

通过查询过滤，用户可以在不改变当前查询语句的情况下，额外添加一些过滤条件。

当查询返回结果后，可以通过展开事件，查看字段详细和查看所有字段界面来加入查询过滤，详细可参照[查询结果表格](#查询结果表格)。
当用户点击字段值添加查询过滤后，会显示在查询输入框下方。如果有不需要的查询过滤条件，可以点击X按钮来删除。 ![search_editor_with_filter](./assets/yhp/search_editor_with_filter.png)

如果用户想要查看包含查询过滤的完整语句，可以点击{:.align-left width="30px" height="30px"}按钮进入查看模式。 switch_mode_full_search

在该模式下，查询输入框为只读，用户不可进行编辑操作。如果需要继续编辑，则需要点击{:.align-left width="30px" height="30px"}按钮。

查询高亮

当用户输入的查询中包含CONTAINS函数，并且查询为类似select * from <EventSet_Name> where contains(<KEYWORDS>)时，所有查询到的关键字均会在查新结果中高亮显示。 search_highlight

查询高亮的视频教程

文档链接

通过点击下面图列中的按钮，用户会被重定向到平台的使用手册和功能文档。

doc_link

SQL查询错误参考

错误代码	错误类型	描述
302	SQL语法错误	后端服务在解析SQL语句失败，SQL语句有语法错误。请修改SQL之后重新提交查询。
14	后端查询服务不可用	后端查询服务不可用，可能是因为后端查询服务崩溃，或者是因为后端查询服务还没有进入可用状态。请联系售后，上报问题。
13	SQL执行错误	后端服务在执行SQL的过程中失败了，通常会有明确的错误信息返回，例如标量函数使用错误，表函数使用错误等。这个错误发生的时候，表示SQL语法没有错误，是SQL运行时错误。请检查SQL语句，重新修改之后提交查询。
8	内存不足，SQL运行失败	后端服务执行SQL的时候，没有足够多的内存完成计算。发生这个错误的时候，是因为查询的时候扫描的数据过多，或者是分配给单个查询任务的内存限制太少，或者是因为查询服务负载过大，内存不够支撑现有的查询。推荐缩小查询时间范围，重新提交查询验证。也可以修改SQL，增加字段裁剪或者字段过滤，减少内存使用。如需调整查询任务的内存上限，请咨询售后。