1 概述
模型参数即在数据模型中定义的参数,模型参数是用于动态设定报表和查询条件的变量,用户可以根据需要设定参数值,从而灵活地调整数据模型的输出结果。
2 模型参数适用什么场景
用户查询时,需要强制默认带上查询条件,减少查询数据量提升查询性能,如银行/证券股常用日期作为分区字段,默认带上日期作为查询条件,命中分区性能才会快。
需要根据不同的参数值输出不同内容,如SQL查询中根据不同参数值,查询不同的表字段内容作为输出字段。
计算度量、计算列、命名集、计算成员等需要引用前端输入的参数值做不同的计算。
如非以上情况,为了数据模型尽量通用(一个主题的模型可支撑该主题业务的所有查询诉求),不建议用数据模型参数,建议在报表层拖筛选器解决,虽然数据模型参数依然可实现旧数据集需要支持的能力。
默认生效解决的是什么场景?什么问题?
比如在模型中设了3个参数,在仪表盘中只用了2个参数,但是还是会按3个参数来过滤。
如下图,在模型定义了2个参数,一个”区域“、一个”省份“,在报表层上只拖了一个”区域“参数,但还是会按照"省份"的默认值去过滤数据,如果想要查看全部区域数据这样就显示不出来。所以增加了一个“默认生效”的选项来进行控制,当不想要“省份”默认生效时,可以把“省份”参数的“参数生效”选项,设为不勾选。
原理:
1、“默认生效”勾选状态 当选择了“默认生效”选项时,无论用户是否在可视化界面上设置了参数值,该参数都将自动应用。这意味着即使用户没有手动输入参数值,系统也会采用参数的默认值来进行计算或过滤,从而实现了参数的强制生效!
2、如果不勾选“默认生效”,则表示参数的使用将遵循按需原则。具体来说:
- 如果取数子图中没有选择与参数相关的表或查询,则该参数不会生效;即使参数被拖入报表中,但如果它与查询的数据不在同一个子图中,该参数也不会生效。
- 只有当参数与查询的数据位于同一个子图中时,该参数才会生效,并且也只对它所映射的那张表生效(即在报表层使用参数时候,只会过滤映射的那张表的数据)。
详细可查看:参数原理视频讲解.mp4。