数据模型-参数应用

应用类型

要求

筛选联动应用：应用于自助仪表盘、电子表格

数据模型中的私有查询资源至少有一个必须带参数，并且该参数必须在数据模型参数面板中设置好映射关系。

各私有查询参数详情请参见：私有查询参数。

参数映射关系详情请参见：参数映射关系。

动态结果应用：应用于计算度量、计算成员、命名集

数据模型参数面板中定义好参数就可以，不需要私有查询资源含参数，也不需要设置映射关系。

参数面板定义参数详情请参见：单个映射。

私有查询参数

私有查询资源除数据源表和导入文件之外，其它几种类型都支持带参数。

SQL查询

SQL查询中，在表达式中通过“${ParamName}”来标识参数，其中“ParamName”为参数名；用“{[ ]}”表示该参数可为空。如：参数表达式 {[id = ${产品编码}]}，表示id字段与参数“产品编码”匹配，且参数允许为空用于输出所有编码的产品。

示例：

示例中的“产品种类”参数在“公共设置-参数定义“中定义，详情请参见：关系数据源参数。

即席查询

即席查询中的参数由拖拽字段生成的条件会自动生成参数。

详情请参考即席查询相关内容。

脚本查询

脚本查询中的参数在脚本代码的结果集中定义。

示例：

详情请参考脚本查询相关内容。

存储过程查询

存储过程查询中的参数在存储过程中定义，在数据模型中执行存储过程查询结果集，显示参数列表及展现结果。

详情请参考存储过程查询相关内容。

ETL高级查询

ETL高级查询只有”关系数据源“节点才支持参数定义，其参数定义通过参数映射以及数据源节点SQL语句的参数筛选共同实现。

参数表达式中的参数名与参数映射时设置的”参数名“必须一致。

详情请参考 ETL高级查询相关内容。

参数映射关系

批量映射

单个映射

筛选联动应用

应用自助仪表盘

应用电子表格

动态结果应用

应用计算度量

应用计算成员

应用命名集

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

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

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

操作步骤

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

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

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

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

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

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

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

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

功能说明