页面树结构
转至元数据结尾
转至元数据起始

正在查看旧版本。 查看 当前版本.

与当前比较 查看页面历史

« 前一个 版本 10 下一个 »

1 概述


2 参数管理

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

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

          


2.1 参数管理功能介绍

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

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

具体步骤如下:

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

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

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

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

选项内容
入口

点击 数据模型工具栏

一键映射
  • 在”参数面板“中单击 一键映射  按钮,系统自动创建模型参数,并建立好与 查询参数 的映射。
  • 自动映射的参数,默认沿用查询参数的名称、数据类型、控件类型等属性,且默认值为静态列表,值为查询参数默认值。
新建参数
  • 单个映射是指手工定义数据模型参数,并将其与私有查询资源中的参数进行映射关系设置。
  • 单击 新建参数  按钮,生成一个模型参数,需要手工映射参数、设置参数信息。
  • 新建的模型参数,映射关系,只允许选择带参数的查询。
复制参数

数据模型的参数支持复用其它数据模型的参数:通过参数复制功能,实现将目标参数克隆到当前数据模型。

控件类型
  • 支持输入框、列表(单选/多选)、列表(单选/多选)、树形(单选/多选)、日期、时间、日期时间。
默认值
  • 默认值可以不填写,代表查询全部数据。
  • 假设 查询 的参数定义“参数 默认值 是必填; 那么在数据模型参数映射之后,默认值也需要填写;否则不能正常查询报表,会提示需要先设置参数默认值。
  •  默认是”静态列表“选项。
备选值
  •  默认是”静态列表“选项,如果“静态列表”满足不了,可以使用 “SQL”,通过写SQL语句动态显示备选值。
  • SQL表达式支持参数嵌套,例如:select * from table where {[id = ${ParamName}]},ParamName为参数名,“{[ ]}”表示该参数可为空。
  • 支持预览sql语句的数据,如果SQL包含了参数,则以参数默认值进行预览。
数据源
  • 数据源:默认值为”静态列表“时不允许修改,默认禁用关联的查询参数的数据源;
  • 默认值为”SQL“选项时支持时,允许选择数据库(当前登录用户拥有查看权限的数据库)

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



3 各个查询类型的参数

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

3.1 SQL查询

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

示例如下图,详情可参考: 创建SQL查询


3.2 即席查询

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

3.3 ETL高级查询

前置条件

1、参数表达式中的参数名与参数设置的”参数名“必须一致。

2、定义参数时,可以设置参数为空;再使用参数的地方,用“{[ ]}”表示该参数可为空,即查询全部数据。

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

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

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

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

3.4 存储过程查询

前置条件

如果存储过程自动识别的参数默认值不能为空,在 数据模型/参数管理 参数映射时也不能设置参数默认值为空,否则会报错。

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

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

3.5 脚本查询

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

3.6 Java查询

前置条件

如果 Java查询 自动识别的参数默认值不能为空,在 数据模型/参数管理 参数映射时也不能设置参数默认值为空,否则会报错。

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

2、详情可参考:Java查询






  • 无标签