# 查询控件
通过查询控件可以对仪表板中的图表进行查询操作，从而展示用户需要的图表数据，查询控件支持对日期类型、文本类型、数值类型的字段进行查询。本文为您介绍如何新建查询控件。
#### 前提条件
- 已创建项目，请参见[创建并管理DataArts Insight项目](https://support.huaweicloud.com/usermanual-dataartsinsight/dataartsinsight_03_0002.html)。
- 已创建数据源，请参见[接入数据源](https://support.huaweicloud.com/usermanual-dataartsinsight/dataartsinsight_0_0455.html)。
- 已创建数据集，请参见[创建数据集](https://support.huaweicloud.com/usermanual-dataartsinsight/dataartsinsight_03_0457.html)。
- 已创建仪表板，请参见[创建仪表板](https://support.huaweicloud.com/usermanual-dataartsinsight/dataartsinsight_03_0402.html)。
 
#### 操作步骤
1. 在仪表板页面导航栏单击![](https://support.huaweicloud.com/usermanual-dataartsinsight/zh-cn_image_0000001628004272.png)，新建查询控件。
2. 在页面右侧的数据页签选择需要分析的数据集。
3. 单击查询控件![](https://support.huaweicloud.com/usermanual-dataartsinsight/zh-cn_image_0000002104099582.png "点击放大")，进入查询控件设置页面。
4. 设置相关参数，参数说明请参见[表1]、[表2]。
5. 单击 "确定"，系统自动更新图表。
6. 单击页面右上角的"保存"或"保存并发布"保存仪表板。 
   图1查询控件设置   
   ![](https://support.huaweicloud.com/usermanual-dataartsinsight/zh-cn_image_0000002168403949.png "点击放大")
   
   
 
 表1查询控件设置参数 
| 参数   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|
| 查询条件 | 命名查询条件的名称，在控件的左上侧展示名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 条件配置 | 对条件的设置，具体请参考[表2]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 关联图表 | 查询条件关联仪表板上的图表内容。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 级联控件 | 级联控件支持展示类型选择下拉列表、日期选择、时间条件框、时间区间选择对数据的过滤。 查询控件的级联功能使用，例如设置的查询条件A中选择了省份，查询条件B中的市列表就只有查询条件A已选定的省份下的市，即需要配置查询条件A和查询条件B的关联关系。 说明： - 时间类型组件只支持级联下拉列表控件。  - 时间条件框、时间区间选择、日期选择级联控件的关联字段时，只能选择对应的时间类型字段。  - 与下拉组件的级联一样，一个时间类型组件可以支持级联多个下拉组件。   |
   
 表2条件配置参数 
| 参数      | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|
| 设为必填选   | 勾选![](https://support.huaweicloud.com/usermanual-dataartsinsight/zh-cn_image_0000001783233998.png)后，查询时会携带查询条件，不勾选![](https://support.huaweicloud.com/usermanual-dataartsinsight/zh-cn_image_0000001783074342.png)，不会携带查询条件。 说明： 查询条件A设置为必选项，条件A前面显示\*，查询条件B为非必选项，条件B前面未显示\*。 当对表格进行查询时，条件A未设置条件，直接对条件B进行设置，单击控件右下角的"查询"时，条件A会显示红色，无法进行数据过滤。只有先设置条件A后，在设置条件B，单击查询控件右下角的"查询"时，不会报错，关联的相应图表展示查询结果。 |
| 展示类型    | 筛选条件支持以下几种展示类型：下拉列表、文本条件框、数字条件框、数字区间选择、日期选择、时间条件框、时间区间选择、条件单选框、列选择器。 说明： 时间区间选择增加了占位符，可以选择区间类型的参数。                                                                                                                                                                                                                                                                                                                                     |
| 选项值来源   | 支持两种方式：自动解析和手动输入。该参数仅在展示类型为下拉列表时支持。 - 自动解析：选择数据集后支持查询字段和显示字段设置。 说明： 关联数据表所过滤的字段中有查询字段的值，在查询控件中查询后，关联的数据表才可显示数据，否则数据表为空。   - 手动输入：查询值和显示名称支持手工录入。                                                              |
| 数据集     | 展示类型为下拉列表时，需要和数据集的字段关联起来。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 查询方式    | 查询方式支持两种方式：单选和多选，该参数仅在展示类型为下拉列表时支持。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 查询时间    | 单击查询，该参数仅在展示类型为下拉列表时支持。 说明： 当数据集字段设置完成之后，便支持设置：设定筛选默认值、筛选、排序、增强检索等功能。                                                                                                                                                                                                                                                                                                                                                                   |
| 设定筛选默认值 | 下拉列表：初始化值选择"固定"并手动选择查询字段的具体数值后，查询控件初始值会默认显示该值；初始化选择"默认第一个值"，查询控件初始值显示为下拉列表的第一个值，其他关联图表也匹配该值。 文本条件框：设定默认筛选值，有以下条件可以设置：精确匹配、包含、不包含、不匹配、开头是、为空、不为空。 数字条件框：设定默认筛选值，有以下条件可以设置：＞、≥、\<、≤、＝、≠。 数字区间选择：设定默认筛选值，手动输入数字区间。 日期选择、时间条件框：设定默认筛选值，支持设置相对时间、绝对时间。 时间区间选择：设定默认筛选值，手动设置时间区间。                                 |
| 默认提示文本  | 条件配置框的默认提示文字。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 提示内容    | 支持设置每个查询条件的提示信息，设置后查询条件名称右侧出现![](https://support.huaweicloud.com/usermanual-dataartsinsight/zh-cn_image_0000002168654929.png "点击放大")，鼠标悬停至![](https://support.huaweicloud.com/usermanual-dataartsinsight/zh-cn_image_0000002168536497.png "点击放大")时展示提示信息。                                                                                                                                                                                                                                                                   |
| 过滤生效    | 该参数仅在展示类型是数字条件框和数字区间选择下支持，有两种的格式的设置：聚合前和聚合后。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 格式化显示   | 该参数仅在展示类型是数字条件框和数字区间下支持，默认值是自动。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 日期类型    | 该参数仅在展示类型是日期选择下支持设置，支持设置：年、季度、月、周、日。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 时间类型    | 该参数在展示类型是时间条件框和时间区间选择下支持设置，支持设置：年、季度、月、周、日、时、分、秒。                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 条件操作符   | 该参数仅在展示类型是时间条件框下支持设置，支持设置：\<、≤、＞、≥、＝。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 字段类别    | 该参数在展示类型是条件单选框下支持设置，支持数值和文本设置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 过滤条件    | 该参数在展示类型是条件单选框下支持设置，数值支持：\<、≤、＞、≥、＝、≠。文本支持：精确匹配、包含、不包含、不匹配、开头是、为空、不为空。                                                                                                                                                                                                                                                                                                                                                                                                                                                      |