跳到主要内容

数据集参数配置

详细介绍仪表盘数据集中动态参数的配置方法和使用技巧

一、数据集基础配置

在配置数据集参数之前,需要先完成数据集的基础配置:

  • 数据集管理数据集管理 - 了解如何创建、编辑和管理数据集
  • SQL数据集类型SQL数据集 - 学习SQL类型数据集的配置方法

二、动态参数字段生成

2.1 参数自动解析

当配置的SQL数据集中包含动态参数(使用 ${参数名} 格式定义)时,系统会自动解析并生成对应的参数字段。您可以为这些参数设置默认值,以便在仪表盘展示时使用。

SQL示例

select name, sex, age from demo where sex="${sex}" and create_time >="${createTime}"

在上述示例中,${sex}${createTime} 是两个动态参数,系统会自动识别并生成对应的参数字段。

参数字段展示参数字段展示

三、参数类型说明

系统支持三种参数类型,每种类型都有其特定的配置方法和使用场景:

3.1 文本类型

文本类型参数使用常规的文本输入框,适用于字符串类型的参数值,如性别、名称等。

3.2 数值类型

数值类型参数使用常规的数值输入框,适用于数字类型的参数值,如年龄、数量等。

3.3 日期类型

日期类型参数提供了更丰富的配置选项,包括:

3.3.1 内置日期

系统内置了常用的日期选项,方便快速选择:

  • 昨天
  • 今天
  • 明天

日期类型参数配置界面日期类型参数配置

3.3.2 自定义日期函数

除了内置日期外,还支持使用自定义日期函数来生成动态日期值。 日期参数默认值配置有专门的设置选项,您可以参考:日期默认值配置

示例:

  • 获取当天日期 =dateStr(0) 获取的值为:2025-08-11
  • 获取前一天日期: =dateStr(-1) 获取的值为: 2025-08-10
  • 获取后一天日期: =dateStr(1) 获取的值为: 2025-08-12

日期默认值配置界面日期默认值配置