创建原生查询数据集

1. 概述

原生查询数据集提供灵活高效的原生查询能力，支持用户直接使用数据库原生语法（如SQL、Elasticsearch DSL等）实时查询数据源，并将原始数据无缝对接至数据可视化大屏和报表中，满足多样化数据分析和实时展示需求。本节将详细介绍如何创建原生查询数据集。

接下来，我们以智能制造实时监控工厂多个设备CPU使用情况为例，详细介绍如何使用原生查询数据集查询设备的CPU数据，并将其展示在可视化大屏上，实现实时监控。以下是数据可视化大屏的实际运行效果的展示。

工厂设备监控

接入数据源：在创建原生查询数据集之前，需先接入数据源。例如，将已采集的设备 CPU 数据存入数据源，然后在原生查询数据集中使用原生语法查询和返回该数据源的数据。
说明：产品支持所有类型的数据源使用原生查询数据集进行建模。需要注意的是，在原生查询数据集中，必须使用每种数据库对应的原生语法来编写查询语句。
以下以 InfluxDB 数据源为例，先创建好一个 InfluxDB 数据源，接入数据库中记录的设备 CPU 的使用率。如下：

以下操作步骤以仪表板为例（报表可参考相同步骤），助您轻松实现数据可视化与实时监控：

步骤一：创建文档，选择仪表板或报表的准备数据

步骤二：使用原生查询语法返回数据

编写查询语句
1）在原生查询数据集设计器中选择已创建好的数据源，编写查询语句，编写完成后，单击校验按钮，校验语法的合理性，确保语法正确。
例如，按照用户场景或者分析需求查询返回某个设备的 cpu0 （设备包含有多个 CPU ）在过去 5 分钟的数据。
预览与保存
1）校验通过后，单击顶部的预览按钮，查看返回的数据是否符合业务场景，最后单击保存按钮保存数据集。
使用参数动态查询

动态查询需求： 在实际分析中，用户可能需要动态查看不同时间段的设备CPU数据（如过去10分钟、过去20分钟等），而非固定的5分钟。为此，原生查询数据集引入了参数功能，支持动态过滤数据。
添加参数： 在原生查询数据集中我们引入了参数，可以使用参数来动态过滤要查看的时间段内的数据，然后在仪表板中动态的设置这个时间段，就可以灵活的查询和返回要展示的数据。
1）在参数区域添加一个名为lastMinutes 的参数，用于表示查询的时间范围，并在查询语句中使用该参数进行过滤。
参数类型与规则： 原生查询数据集支持用户输入、用户上下文和组织上下文三种类型，用户可根据业务场景选择合适的类型进行数据过滤和隔离。
参数使用规则：
- 参数名必须以字母或下划线开头，并且整个参数名中只能包含字母、数字和下划线；
- 无论使用哪种参数类型，都必须为其设置默认值；
- 参数在查询语句中的调用方式为 “@”+参数名；
- 如果查询语句需要使用@符号来表示非参数语句，需要在@符号前加上\\；
校验和预览： 校验和预览时，系统会弹出参数输入框，用户可设置参数值并查看查询结果是否符合业务需求。

字段别名与描述
使用原生语法查询时，返回的字段名称通常与数据库中的名称一致。为了更好地识别字段或帮助业务人员快速理解字段含义，可以为字段设置别名（别名在后续使用中将代替原有字段名称）并添加字段描述信息。当字段较多时，可使用右上角的搜索按钮，按字段名称关键字进行快速查找。

Wyn 成功创建原生查询数据集后，可以在「文档门户>我的分析>数据集」列表中找到创建成功的原生查询数据集。更多介绍，请见数据集/数据模型协作与管理。