1 概述

2 参数管理

数据模型参数主要的作用有如下两个方面：

• 实现 查询 里面定义的参数与数据模型 参数管理 里面的映射关系：它类似于中间件功能，将私有查询参数与数据模型参数进行关联。应用详情请参见：参数筛选应用、参数联动应用。
• 应用到计算度量、计算成员和命名集表达式中，实现动态获取结果。应用详情请参见：动态结果应用。

2.1 参数映射、参数筛选

如果在查询中定义了参数，可以数据模型的参数管理进行映射、定义参数名称、数据类型、控件类型、默认值、备选值。

示例：根据输入的订单日期查询订单信息。

具体步骤如下：

1、创建数据模型并且在模型中添加 SQL查询 。

2、在 SQL查询 选择产品自带的northwind数据库下的”orders“表，编写SQL语句如下，代表可以参数ParamName默认值可以为空：

3、保存SQL查询并回到模型。

4、点击参数工具栏的进入参数管理界面,映射参数，并设置参数相关选项：

5、设置好参数后，保存数据模型，并去创建 交互式仪表盘，制作组件，并且拖入参数，可以根据参数查询订单信息，效果如下：

• 如果是数据模型是 直连模式，则可以根据切换参数值动态筛选；
• 如果数据模型是 抽取 模式，则只能根据设置的默认值筛选，无法动态切换。

2.2 参数联动

参数联动是指参数A的选择影响参数B可选值的一种动态效果。

示例：区域、省份 参数联动查询。

具体步骤如下：

1、创建数据模型并且在模型中添加 即席查询 。

2、在 即席查询 选择产品自带的northwind数据库，分别拖拽”发货区域“和”省份“字段到条件区，自动生成两个参数:

3、保存即席查询后，并返回数据模型。

4、单击数据模型 设置参数 按钮，打开 参数管理 窗口，单击 一键映射 按钮，自动创建模型参数并映射即席查询中的参数：按照如下修改这两个参数设置：

5、参数设置后，保存该数据模型。

6、创建自助仪表盘，并去创建 交互式仪表盘，制作组件，并且从右侧资源树拖入“销售区域”与参数“销售省份”，联动动态效果如下：

3 各个查询类型的参数

目前数据模型查询类型除数据源表(HaNa数据库的表可以有参数)、导入文件、日期表 之外，其它几种类型都支持带参数。

3.1 SQL查询

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

示例如下图，详情可参考： 创建SQL查询。

3.2 即席查询

即席查询中的参数由拖拽字段生成的条件会自动生成参数，详情可参考：创建即席查询。

3.3 ETL高级查询

1、在ETL高级查询支持定义参数，先在ETL高级查询定义好参数之后，再用到可以调用参数的地方或者节点上。

2、ETL高级查询可以在”关系数据源“、“数据查询”节点使用定义好的参数，详情可参考：自助ETL。

  “数据查询”节点使用参数：

 ”关系数据源“节点使用参数：

3.4 存储过程查询

1、存储过程查询中的参数在定义存储过程的时候定义，根据参数默认值输出结果集。

2、详情可参考：接入存储过程查询。

3.5 脚本查询

脚本查询中的参数在脚本代码的结果集中定义，根据参数默认值输出结果集。

3.6 Java查询

1、存储过程查询中的参数在定义存储过程的时候定义，根据参数默认值输出结果集。

2、详情可参考：Java查询。