DQL 查询¶

简介¶

在观测云工作空间，点击菜单栏的快捷入口 > 查询工具即可打开查询查看器，或者您可以通过快捷键 Alt+Q 或 option+Q 直接打开查询工具。

点击 DQL 查询右侧的 简单查询、PromQL 查询 按钮即可切换查询方式。

相关操作¶

返回结果¶

在 DQL 查询窗口输入 DQL 查询语句，点击执行，即可在返回结果查看查询结果。返回结果以表格形式返回查询结果，默认返回 1000 条数据，您可以将返回数据导出为 CSV 文件。

注意：在使用 DQL 查询语句时，支持使用 limit 或 slimit 来控制返回查询结果数量。

若 DQL 查询语句有误，也可在返回结果查看错误提示。

JSON¶

若 DQL 查询语句正确，返回查询结果后，可在 JSON 查看 JSON 结构的查询结果，支持复制 JSON。若 DQL 查询返回错误结果，则在 JSON 同时提示错误信息。

查询历史¶

查询历史支持按日查看 7 天内的 100 条查询历史数据，支持对查询语句进行模糊搜索。

点击查询历史数据右侧的执行按钮 ，直接展示对应的查询语句及查询结果。

DQL 语法¶

DQL 查询遵循如下的语法范式，各个部分之间的相对顺序不能调换，从语法角度而言，data-source 是必须的（类似于 SQL 中的 FROM 子句），其它部分都是可选的。

更多 DQL 语法介绍可参考文档 DQL 定义。

namespace::
    data-source
    target-clause
    filter-clause
    time-expr
    by-clause
    limit-clause
    offset-clause
    slimit-clause
    soffset-clause

示例说明¶

下面是一个简单的示例，通过 DQL 查询时序指标集 cpu 的字段 usage_idle (CPU空闲率)，以 host 来过滤筛选，同时以 host 来分组显示结果。其中 #{host} 是在观测云仪表板设置的视图变量，用于过滤筛选。

把上面的语句应用到观测云场景仪表版的图表查询中，下图结合表达式查询和 DQL 查询，展示最近 15 分钟 CPU 使用率。

DQL 函数¶

DQL 查询除了可以在场景仪表板中使用以外，我们还可以通过 DQL 函数来查询 DataKit 采集的各种数据，如数据来源、字段、标签等。

SHOW 函数¶

SHOW 函数用于展示各类数据。若对通过 DataKit 采集的数据来源、字段、标签等没有清晰的了解，可以在 DQL 查询查看器通过 SHOW 函数来查询。

下面通过 SHOW 函数查询“对象”和“日志”的来源、字段等数据。

更多函数介绍可参考文档 DQL 函数 以及 DQL 外层函数。

show_object_source()¶

展示 object 数据的指标集合。

show_object_field()¶

展示对象的 fileds 列表。

show_object_label()¶

展示对象包含的标签信息。

show_logging_source()¶

展示日志数据的指标集合。

show_logging_field()¶

展示指定 source 下的所有 fileds 列表。