在PowerBI Desktop中,用户可以定义一个或多个查询参数(Query Parameter),通常的用法是通过查询参数定义数据查询(Query),在数据模型中创建关系,通过DAX表达式引用参数。在查询编辑器(Query Editor)中,用户通过菜单“Manage Parameters”创建和管理参数,参数有Name属性,参数的数据类型,以及参数的类型(List of Values,ListQuery),当前值(Current Value)等属性,用于手动枚举参数的值,或则指定一个List查询,参数的值是List查询的值。参数不管有多少个可能的值(Available Value),只能有一个当前值,所谓引用参数值,实际上是指引用参数的当前值(Current Value),参数的当前值,只能在查询编辑器(Query Editor)中手动修改,不能动态变化。
一,创建和管理参数
本文创建ListQuery类型的参数来演示如何对创建和管理参数,首先必需有一个ListQuery,创建List Query的详细过程,请参考《PowerBI开发 第三篇:报表设计技巧》。创建ListQuery的步骤是:打开查询编辑器(Query Editor),选中已经存在的Query的某一列,右击弹出快捷菜单,点击“Add as New Query”,这样创建的Query就是List类型的Query。新建的List Query的Name是选中的字段名,该ListQuery只有一列,初始的列名是List。ListQuery是特殊类型的Query,同样位于左侧的“Queries”列表中,默认是被加载到Data Model中,其属性“Enable Load”默认是勾选的,ListQuery的图标不同于常规的查询,例如,名字为Area的ListQuery的图标是:。
例如,创建ListQuery类型的参数,输入参数的Name,参数的数据类型,选择参数的类型(Suggested Values)为Query(即参数类型是ListQuery),选择参数引用的ListQuery(下图中参数的值从Area中获取),勾选必需(Required)属性表示:用户必须指定参数的当前值(Current Value),新建的参数如下图所示:
创建参数之后,在左侧的“Queries”列表中出现一个查询(Query),查询的Name是参数的Name。参数和常规的查询一样,能够被其他查询引用,能够被加载到数据模型(Data Model),也能够被其他DAX表达式引用。默认情况下,查询参数是不会被加载到Data Model中,用户必需手动启用数据加载选项:选中参数,右击弹出快捷菜单,点击“Enable Load”,使PowerBI把参数加载到Data Model中。
例如,创建Text类型的Parameter1,当前值是host1,勾选“Enable Load”,启用参数的加载属性:
二,引用参数
参数的值可能有很多,而引用的是参数的当前值(Current Value),用户可以在查询编辑器(Query Editor)中手动修改参数的当前值,参数通常用于“Get Data” 和 “Query Editor”,也可用于DAX表达式中。
1,在创建数据查询时,引用参数
通过“Get Data”新建SQL Server类型的数据查询时,可以通过参数设置数据源的Server,Database等属性,如图:
如果PowerBI报表中引用多个查询,而查询使用的底层数据源是相同的,在这样的场景下,用户可以创建参数,参数值是用于连接数据源的连接字符串(Connection String),例如,SQL Server实例,SQL Server Database的名称等,在新建查询时,只需要选中参数,便于统一管理数据源的连接字符串等属性。
2,使用参数替换查询的值
在查询编辑器(Query Editor)中,通过“Replace Values”菜单,图标是:,用户使用参数,查找已经存在的值,替换为其他参数的值。
3,使用参数过滤查询的值
在查询编辑器(Query Editor)中,选中Text类型的Column,点击向下的三角“”,弹出快捷菜单,选择“Text Filters”:
弹出“Filter Rows”的窗体,引用参数查询字段值,并把查找的值替换为其他值,而替换的值也可以通过参数来配置:
3,DAX表达式引用查询参数
参数和常规的查询是一样的,是关系数据(tabular data),能够用于DAX表达式的表表达式(Table Expression)中。
new measure = "max parameter="& MAX(Parameter1[Parameter1])
三,查询参数的打开方式
在开发PowerBI报表时,除了使用参数统一管理连接字符串(Connection String)之外,没有发现查询参数的其他打开方式,参数的创建和管理,都是在查询编辑器(Query Editor)中完成的,数据是一次性加载的,不能动态改变,没有交互性,但是,用户可以通过参数手动刷新数据,在查询编辑器中修改参数的值之后,可以通过“Refresh Data”或“Apply Changes”手动刷新Data Model的值。个人认为,在PowerBI的开发中,参数的适用场景有限,是个鸡肋。
参考文档:
Deep Dive into Query Parameters and Power BI Templates
POWER BI DESKTOP QUERY PARAMETERS, PART 1