应用类型 | 要求 |
---|---|
筛选联动应用:应用于自助仪表盘、电子表格 | 数据模型中的私有查询资源至少有一个必须带参数,并且该参数必须在数据模型参数面板中设置好映射关系。 各私有查询参数详情请参见:私有查询参数。 参数映射关系详情请参见:参数映射关系。 |
动态结果应用:应用于计算度量、计算成员、命名集 | 数据模型参数面板中定义好参数就可以,不需要私有查询资源含参数,也不需要设置映射关系。 参数面板定义参数详情请参见:单个映射。 |
私有查询参数
私有查询资源除数据源表和导入文件之外,其它几种类型都支持带参数。
SQL查询
SQL查询中,在表达式中通过“${ParamName}”来标识参数,其中“ParamName”为参数名;用“{[ ]}”表示该参数可为空。如:参数表达式 {[id = ${产品编码}]},表示id字段与参数“产品编码”匹配,且参数允许为空用于输出所有编码的产品。
示例:
示例中的“产品种类”参数在“公共设置-参数定义“中定义,详情请参见:关系数据源参数。
即席查询
即席查询中的参数由拖拽字段生成的条件会自动生成参数。
详情请参考 即席查询 相关内容。
脚本查询
脚本查询中的参数在脚本代码的结果集中定义。详情请参考 脚本查询-参数 。
存储过程查询
存储过程查询中的参数在存储过程中定义,在数据模型中直接执行存储过程查询后,展现结果:
通过Tab页的形式将参数设置区和预览数据区进行展示。详情请参考 存储过程查询-参数 。
ETL高级查询
ETL高级查询中的参数通过参数设置与编写数据源的SQL语句进行参数筛选。详情请参考 ETL高级查询-界面介绍 。
参数映射关系
批量映射
单个映射
筛选联动应用
应用自助仪表盘
应用电子表格
动态结果应用
应用计算度量
应用计算成员
应用命名集
在数据模型中,可以设置每个私有查询的参数(除了数据源表和导入文件),并将私有查询的参数映射到数据模型中进行管理。
参数暂不支持映射到数据源表查询、导入文件查询。
下面以即席查询为例,演示如何设置数据模型的参数。
操作步骤
1、新建即席查询,选择数据源并拖拽字段如图:
2、拖拽字段作为查询的参数,并设置参数属性和默认值,保存后回到数据模型。
3、设置即席查询的度量,然后点击“设置参数”按钮,进入参数管理界面。
在参数管理界面中,点击 参数关联列表 ,可查看未映射到数据模型的参数。
注意:私有查询中设置的参数不能直接用于报表中,需要在参数管理中映射到数据模型里才能使用。
4、点击 一键映射 按钮,将即席查询设置的参数映射到数据模型中。如果查询中设置的参数未映射到数据模型中,也可点击 添加 按钮,手动添加映射,详情请参考 参数列表区 。
5、可以修改参数属性,保存参数管理和数据模型。
6、新建一个自助仪表盘,数据来源选择刚才设置的数据模型,然后拖拽参数到展现区,直接使用参数即可。
功能说明
设置私有查询的参数
SQL查询
1、输入SQL查询语句。
参数示例:select * from table where {[id = ${ParamName}]},ParamName为参数名,“{[ ]}”表示该参数可为空。
2、输入参数默认值。
3、点击 运行 按钮,查看输出数据。
详情请参考 SQL查询 。
即席查询
在即席查询中由拖拽字段生成的条件会自动生成参数。详情请参考 即席查询-参数 。
脚本查询
在脚本查询中在脚本代码的结果集中定义参数。详情请参考 脚本查询-参数 。
存储过程查询
在存储过程查询中通过Tab页的形式将参数设置区和预览数据区进行展示。详情请参考 存储过程查询-参数 。
ETL高级查询
在ETL高级查询中通过参数设置与编写数据源的SQL语句进行参数筛选。详情请参考 ETL高级查询-界面介绍 。
参数管理
参数管理界面中包含了所有私有查询的参数,用户需要对这些参数进行管理并将私有查询的参数映射到数据模型中。如图:
参数列表区
功能 | 说明 | |
---|---|---|
一键映射 | 自动将所有私有查询的参数映射到数据模型中。 自动新建参数并映射的规则:参数数据类型与参数名称一致。 一个数据模型的参数可以映射多个私有查询的参数,但是一个私有查询参数只能关联一个数据模型的参数。 | |
添加 | 参数数据类型与参数名称不一致,可手动添加参数映射关系:
| |
列表 | 映射关系 | 数据模型参数与私有查询参数之间的映射。如果是已有映射关系的参数,参数置灰且不可选。 |
删除 | 删除参数映射关系。 |
参数设置区
参数设置区包含了一些参数的属性。
名称 | 说明 |
---|---|
名称 | 参数的名称。 |
数据类型 | 参数的数据类型 |
控件类型 | 参数的控件类型,默认为字符串。控件类型包括:
当参数的数据类型是字符串或日期,参数控件类型选择日期控件下的日期类型时,数据格式如下:
当参数的数据类型是非字符串、非日期时,控件类型不能选择日期。 详情请参考 参数定义 。 |
数据源 | 参数的数据来源,下拉框中展示的是登录用户有查看权限数据库,默认是禁用状态。 数据源影响的设置项:默认值、真实值、显示值。 当默认值为“SQL”时,数据源下拉框自动变成可选状态。 |
默认值 | 参数的默认值。 |
应用于报表
自助仪表盘
数据模型的参数可在自助仪表盘中直接拖拽使用,详情请参考 自助仪表盘-参数 。
电子表格
数据模型的参数可在电子表格中使用,详情请参考 电子表格-参数面板设计 。