在数据模型中,可以设置每个私有查询的参数(除了数据源表和导入文件),并将私有查询的参数映射到数据模型中进行管理。

参数暂不支持映射到数据源表查询、导入文件查询。

下面以即席查询为例,演示如何设置数据模型的参数。

操作步骤

1、新建即席查询,选择数据源并拖拽字段如图:

2、拖拽字段作为查询的参数,并设置参数属性和默认值,保存后回到数据模型。

3、设置即席查询的度量,然后点击“设置参数”按钮,进入参数管理界面。

在参数管理界面中,点击 参数关联列表 ,可查看未映射到数据模型的参数。

注意:私有查询中设置的参数不能直接用于报表中,需要在参数管理中映射到数据模型里才能使用。

4、点击 一键映射 按钮,将即席查询设置的参数映射到数据模型中。如果查询中设置的参数未映射到数据模型中,也可点击 添加 按钮,手动添加映射,详情请参考 参数列表区

5、可以修改参数属性,保存参数管理和数据模型。

6、新建一个自助仪表盘,数据来源选择刚才设置的数据模型,然后拖拽参数到展现区,直接使用参数即可。

功能说明

设置私有查询的参数

SQL查询

1、输入SQL查询语句。

参数示例:select * from table where {[id = ${ParamName}]},ParamName为参数名,“{[ ]}”表示该参数可为空。

2、输入参数默认值。

3、点击 运行 按钮,查看输出数据。

详情请参考 SQL查询 。

即席查询

在即席查询中由拖拽字段生成的条件会自动生成参数。详情请参考 即席查询-参数 。

脚本查询

在脚本查询中在脚本代码的结果集中定义参数。详情请参考 脚本查询-参数 。

存储过程查询

在存储过程查询中通过Tab页的形式将参数设置区和预览数据区进行展示详情请参考 存储过程查询-参数

ETL高级查询

在ETL高级查询中通过参数设置与编写数据源的SQL语句进行参数筛选。详情请参考 ETL高级查询-界面介绍 。

参数管理

参数管理界面中包含了所有私有查询的参数,用户需要对这些参数进行管理并将私有查询的参数映射到数据模型中。如图:

参数列表区

功能说明
一键映射

自动将所有私有查询的参数映射到数据模型中。

自动新建参数并映射的规则:参数数据类型与参数名称一致。

一个数据模型的参数可以映射多个私有查询的参数,但是一个私有查询参数只能关联一个数据模型的参数。

添加

参数数据类型与参数名称不一致,可手动添加参数映射关系:

  1. 点击 添加 按钮,新建参数并设置参数属性;
  2. 点击映射关系下拉框,添加参数映射关系

列表映射关系

数据模型参数与私有查询参数之间的映射。如果是已有映射关系的参数,参数置灰且不可选。

删除删除参数映射关系。


参数设置区

参数设置区包含了一些参数的属性。

名称说明
名称参数的名称。
数据类型参数的数据类型
控件类型

参数的控件类型,默认为字符串。控件类型包括:

  • 文本
  • 列表(单选)
  • 列表(多选)
  • 下拉(单选)
  • 下拉(多选)
  • 树形(单选)
  • 树形(多选)
  • 日期

当参数的数据类型是字符串或日期,参数控件类型选择日期控件下的日期类型时,数据格式如下:

  • 日期:默认显示yyyy-MM-dd
  • 时间:默认显示HH:mm:ss
  • 日期时间:默认显示yyyy-MM-dd HH:mm:ss
  • 年:默认显示yyyy
  • 年季:默认显示yyyyQ[1|2|3|4]
  • 年月:默认显示yyyyMM
  • 年周:默认显示yyyyW[1|2|3...]

当参数的数据类型是非字符串、非日期时,控件类型不能选择日期。

详情请参考 参数定义 。

数据源

参数的数据来源,下拉框中展示的是登录用户有查看权限数据库,默认是禁用状态。

数据源影响的设置项:默认值、真实值、显示值。

当默认值为“SQL”时,数据源下拉框自动变成可选状态。

默认值参数的默认值。

应用于报表

自助仪表盘

数据模型的参数可在自助仪表盘中直接拖拽使用,详情请参考 自助仪表盘-参数

电子表格

数据模型的参数可在电子表格中使用,详情请参考 电子表格-参数面板设计 。