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

2.3 下拉树参数

示例：查询区域-省份-运费列表

具体操作步骤如下：

1、创建数据模型，并且在模型中增加即席查询，并且把 省份 作为筛选条件，如下图：

2、保存模型，并且在 参数管理映射对应的参数，以及编写SQL构建层级关系，该示例为2层：

select
  distinct  T6.`ShipRegion` as `F1`,
    T6.`ShipProvince` as `F0`
from
 `northwind_orders`   T6
limit 1

select
  distinct  T6.`ShipRegion` as `F1`,
    T6.`ShipProvince` as `F0`
from
 `northwind_orders`   T6

select
  distinct  T6.`ShipRegion` as `F1`
from
 `northwind_orders`   T6

3、创建好参数之后，保存模型去创建仪表盘，拖入参数，可查看下拉树作为参数效果以及筛选效果：

2.4 参数动态应用

参数在计算度量、计算成员和命名集中的应用可以实现根据参数取值的不同而动态获取结果。

2.4.1 参数应用于计算度量

示例： 根据参数”结算时间点“选择的值，显示从当年1月1日至所选时间点的销量总和。

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

2、在 即席查询 选择产品自带的northwind数据库，拖拽字段如下：

3、保存即席查询后，并返回数据模型，基于时间字段”订单日期 创建时间层次，并且保存模型：

4、创建参数"结算时间点"

5、创建计算度量”累计销售量“，并且引用参数"结算时间点"，其中

• 表达式中的YTD()，表示从年初至今累计；
• 时间层次”[年月日]“中的成员通过”结算时间点“获取，用于实现动态时间结算；
• SUM是聚合函数
• 度量:[销量]

6、保存计算度量及数据模型后，在交互式仪表盘中使用该计算度量：

2.4.2 参数应用于计算成员

详情也查看：自定义计算成员。

示例：排除所选区域的销售汇总。

具体操作步骤如下：

1、基于 2.3.1 创建好的数据模型，创建地理维度:

2、在数据模型创建参数“销售区域”：

3、创建计算成员”排除所选区域外度量汇总“：

5、保存计算成员及数据模型后，在自助仪表盘中运用该计算成员：

2.4.3 参数应用于命名集

详情也查看：自定义命名集。

示例：排除所选区域的销售汇总。

具体操作步骤如下：

1、基于 2.3.1 创建好的数据模型，参数“销量”：

2、创建命名集”销量大于某值的区域“：

5、保存命名集及数据模型后，在自助仪表盘中运用该命名集，可以通过参数”销量“实现动态变更

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查询。