页面树结构

版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

1 概述

模型参数即在数据模型中定义的参数,模型参数是用于动态设定报表和查询条件的变量,用户可以根据需要设定参数值,从而灵活地调整数据模型的输出结果。

2 模型参数适用什么场景

  • 用户查询时,需要强制默认带上查询条件,减少查询数据量提升查询性能,如银行/证券股常用日期作为分区字段,默认带上日期作为查询条件,命中分区性能才会快。

  • 需要根据不同的参数值输出不同内容,如SQL查询中根据不同参数值,查询不同的表字段内容作为输出字段。

  • 计算度量、计算列、命名集、计算成员等需要引用前端输入的参数值做不同的计算。

如非以上情况,为了数据模型尽量通用(一个主题的模型可支撑该主题业务的所有查询诉求),不建议用数据模型参数,建议在报表层拖筛选器解决,虽然数据模型参数依然可实现旧数据集需要支持的能力。

默认生效解决的是什么场景?什么问题?

比如在模型中设了3个参数,在仪表盘中只用了2个参数,但是还是会按3个参数来过滤。

如下图,在模型定义了2个参数,一个”区域“、一个”省份“,在报表层上只拖了一个”区域“参数,但还是会按照"省份"的默认值去过滤数据,如果想要查看全部区域数据这样就显示不出来。所以增加了一个“默认生效”的选项来进行控制,当不想要“省份”默认生效时,可以把“省份”参数的“参数生效”选项,设为不勾选。

...



2 参数 "默认生效“在同一个子图示例

1、以产品内置的northwind创建数据模型,在数据模型中创建SQL查询,并且使用参数"区域"、“省份”参数进行过滤:

Image Added

2、保存SQL查询,回到数据模型主界面,添加“订单明细表”、“产品表”到数据模型中,并且设置好关联关系:

Image Added

3、在设置参数中映射参数,并且定义参数的默认值、备选值,把2个的“参数生效”:默认生效 设为勾选

Image Added

预览“区域”参数的默认值为:“华北”:

Image Added

4、去创建透视分析并且把省份“的参数拖入到过滤条件,”区域“参数不拖效果如下图:

Image Added

虽然“省份”查询“全部”的数据,但是还是会根据”区域“的默认参数进行查询。

5、把”区域“的”参数生效“改成不勾选,清空缓存之后,刷新报表,结果还是会以”区域“参数默认值进行过滤:

Image Added




2 参数 "默认生效“在同一个子图示例



原理:

1、“默认生效”勾选状态 当选择了“默认生效”选项时,无论用户是否在可视化界面上设置了参数值,该参数都将自动应用。这意味着即使用户没有手动输入参数值,系统也会采用参数的默认值来进行计算或过滤,从而实现了参数的强制生效!

...

  • 如果取数子图中没有选择与参数相关的表或查询,则该参数不会生效;即使参数被拖入报表中,但如果它与查询的数据不在同一个子图中,该参数也不会生效。
  • 只有当参数与查询的数据位于同一个子图中时,该参数才会生效,并且也只对它所映射的那张表生效(即在报表层使用参数时候,只会过滤映射的那张表的数据)。

详细可查看:参数原理视频讲解.mp4

2 适用场景

...