SUMMARIZECOLUMNS
返回一组组的摘要表。
语法
SUMMARIZECOLUMNS( <groupBy_columnName> [, < groupBy_columnName >]…, [<filterTable>]…[, <name>, <expression>]…)
parameters
术语 | 定义 |
---|---|
groupBy_columnName | 对基表的完全限定的列引用(表 [列]),其返回的表中包含不同的值。 每个 groupBy_columnName 列都与后续指定的列交叉联接(不同的表)或自动共存(相同的表)。 |
filterTable | 添加到指定为 groupBy_columnName 参数的所有列的筛选上下文中的表表达式。 筛选器表中存在的值用于在执行交叉联接/自动共存之前进行筛选。 |
name | 表示要用于指定的后续表达式的列名称的字符串。 |
表达式 | 任何返回单个值(而不是表)的 DAX 表达式。 |
返回值
一个表,它根据指定的分组包含所提供列的值的组合。 返回的表中仅包含符合后列条件的行:提供的表达式种至少有一个为其返回非空值。 如果一行的所有表达式的计算结果都为 BLANK/NULL,则该行不包含在返回的表中。
备注
此函数不保证结果的任何排序顺序。
不能在 groupBy_columnName 参数中多次指定某一列。 例如,下面的公式无效。
SUMMARIZECOLUMNS( Sales[StoreId], Sales[StoreId] )
在已计算的列或行级安全性 (RLS) 规则中使用时,不支持在 DirectQuery 模式下使用此函数。
筛选器上下文
请考虑下列查询:
SUMMARIZECOLUMNS ( 'Sales Territory'[Category], FILTER('Customer', 'Customer' [First Name] = "Alicia") )
在此查询中,如果没有度量值,则 groupBy 列不包含 FILTER 表达式中的任何列(例如来自“客户”表的列)。 筛选器不应用于 groupBy 列。 “销售区域”和“客户”表可通过“分销商销售”事实数据表间接关联。 由于它们不是直接关联的,因此筛选器表达式不执行任何操作,并且 groupBy 列不受影响。
但是,对于以下查询:
SUMMARIZECOLUMNS ( 'Sales Territory'[Category], 'Customer' [Education], FILTER('Customer', 'Customer'[First Name] = "Alicia") )
groupBy 包含一个受筛选器影响的列,该筛选器应用于 groupBy 结果。
使用 IGNORE
可通过在 BLANK/NULL 计算中省略特定表达式,使用 IGNORE 语法修改 SUMMARIZECOLUMNS 函数的行为。 未使用 IGNORE 返回 BLANK/NULL 的所有表达式的行将被排除,且与使用 IGNORE 的表达式的计算结果是否为 BLANK/NULL 无关。 IGNORE 只能在 SUMMARIZECOLUMNS 表达式中使用。
示例
SUMMARIZECOLUMNS( Sales[CustomerId], "Total Qty", IGNORE( SUM( Sales[Qty] ) ), "BlankIfTotalQtyIsNot3", IF( SUM( Sales[Qty] )=3, 3 ) )
这将汇总 Sales[CustomerId] 列,为给定分组中的所有客户创建小计。 不使用 IGNORE,结果为:
CustomerId | TotalQty | BlankIfTotalQtyIsNot3 |
---|---|---|
A | 5 | |
B | 3 | 3 |
C | 3 | 3 |
使用 IGNORE,
CustomerId | TotalQty | BlankIfTotalQtyIsNot3 |
---|---|---|
B | 3 | 3 |
C | 3 | 3 |
已忽略所有表达式,
SUMMARIZECOLUMNS( Sales[CustomerId], "Blank", IGNORE( Blank() ), "BlankIfTotalQtyIsNot5", IGNORE( IF( SUM( Sales[Qty] )=5, 5 ) ) )
即使这两个表达式在某些行中都返回空白,它们也被包含在内,因为返回了空白的表达式均被忽略了。
CustomerId | TotalQty | BlankIfTotalQtyIsNot3 |
---|---|---|
A | 5 | |
B | ||
C |
使用 NONVISUAL
NONVISUAL 函数将 SUMMARIZECOLUMNS 函数中的值筛选器标记为不影响度量值,但它仅应用于 groupBy 列。 NONVISUAL 只能在 SUMMARIZECOLUMNS 表达式中使用。
示例
DEFINEMEASURE FactInternetSales[Sales] = SUM(FactInternetSales[Sales Amount])EVALUATESUMMARIZECOLUMNS( DimDate[CalendarYear], NONVISUAL(TREATAS({ 2007, 2008 }, DimDate[CalendarYear])), "Sales", [Sales], "Visual Total Sales", CALCULATE([Sales], ALLSELECTED(DimDate[CalendarYear])))ORDER BY [CalendarYear]
返回结果,其中 [直观总销售额] 是所有年份的总计:
DimDate[CalendarYear] | [销售额] | [直观总销售额] |
---|---|---|
2007 | 9,791,060.30 | 29,358,677.22 |
2008 | 9,770,899.74 | 29,358,677.22 |
与此相反,未使用 NONVISUAL 函数的相同查询:
DEFINEMEASURE FactInternetSales[Sales] = SUM(FactInternetSales[Sales Amount])EVALUATESUMMARIZECOLUMNS( DimDate[CalendarYear], TREATAS({ 2007, 2008 }, DimDate[CalendarYear]), "Sales", [Sales], "Visual Total Sales", CALCULATE([Sales], ALLSELECTED(DimDate[CalendarYear])))ORDER BY [CalendarYear]
返回结果,其中 [直观总销售额] 是两个选定年份的总计:
DimDate[CalendarYear] | [销售额] | [直观总销售额] |
---|---|---|
2007 | 9,791,060.30 | 19,561,960.04 |
2008 | 9,770,899.74 | 19,561,960.04 |
使用 ROLLUPADDISSUBTOTAL
添加 ROLLUPADDISSUBTOTAL 语法后,通过向基于 groupBy_columnName 列的结果添加汇总行/小计行来修改 SUMMARIZECOLUMNS 函数的行为。 ROLLUPADDISSUBTOTAL 只能在 SUMMARIZECOLUMNS 表达式中使用。
有单个小计的示例
DEFINEVAR vCategoryFilter = TREATAS({ "Accessories", "Clothing" }, Product[Category])VAR vSubcategoryFilter = TREATAS({ "Bike Racks", "Mountain Bikes" }, Product[Subcategory])EVALUATE SUMMARIZECOLUMNS ( ROLLUPADDISSUBTOTAL ( Product[Category], "IsCategorySubtotal", vCategoryFilter, Product[Subcategory], "IsSubcategorySubtotal", vSubcategoryFilter ), "Total Qty", SUM(Sales[Qty]) ) ORDER BY [IsCategorySubtotal] DESC, [Category], [IsSubcategorySubtotal] DESC, [Subcategory]
返回下表,
类别 | Subcategory | IsCategorySubtotal | IsSubcategorySubtotal | 总数量 |
---|---|---|---|---|
True | True | 60398 | ||
Accessories | False | True | 36092 | |
Accessories | 自行车车架 | False | False | 328 |
Bikes | 山地自行车 | False | False | 4970 |
Clothing | False | True | 9101 |
有多个小计的示例
SUMMARIZECOUMNS ( Regions[State], ROLLUPADDISSUBTOTAL ( Sales[CustomerId], "IsCustomerSubtotal" ), ROLLUPADDISSUBTOTAL ( Sales[Date], "IsDateSubtotal"), "Total Qty", SUM( Sales[Qty] ) )
销售额按州省/自治区/直辖市、客户、日期分组,包含以下内容的小计:1. 按州省/自治区/直辖市、按日期所得的销售额 2. 按州省/自治区/直辖市、按客户所得销售额 3. 汇总客户和日期销售额,得到州销售额。
返回下表,
CustomerID | IsCustomerSubtotal | 状态 | 总数量 | Date | IsDateSubtotal |
---|---|---|---|---|---|
A | FALSE | WA | 5 | 2014/7/10 | |
B | FALSE | WA | 1 | 2014/7/10 | |
B | FALSE | WA | 2 | 2014/7/11 | |
C | FALSE | OR | 2 | 2014/7/10 | |
C | FALSE | OR | 1 | 2014/7/11 | |
true | WA | 6 | 2014/7/10 | ||
true | WA | 2 | 2014/7/11 | ||
true | OR | 2 | 2014/7/10 | ||
true | OR | 1 | 2014/7/11 | ||
A | FALSE | WA | 5 | true | |
B | FALSE | WA | 3 | true | |
C | FALSE | OR | 3 | TRUE | |
TRUE | WA | 8 | TRUE | ||
TRUE | OR | 3 | true |
使用 ROLLUPGROUP
与 SUMMARIZE 函数一样,ROLLUPGROUP 可与 ROLLUPADDISSUBTOTAL 一起使用,以指定要包含的摘要组/粒度(小计)(减少返回的小计行数)。 ROLLUPGROUP 只能在 SUMMARIZECOLUMNS 或 SUMMARIZE 表达式中使用。
有多个小计的示例
SUMMARIZECOLUMNS( ROLLUPADDISSUBTOTAL( Sales[CustomerId], "IsCustomerSubtotal" ), ROLLUPADDISSUBTOTAL(ROLLUPGROUP(Regions[City], Regions[State]), "IsCityStateSubtotal"),"Total Qty", SUM( Sales[Qty] ) )
仍按城市和省/自治区/直辖市分组,但在报告小计时汇总在一起返回下表,
状态 | CustomerId | IsCustomerSubtotal | 总数量 | 城市 | IsCityStateSubtotal |
---|---|---|---|---|---|
WA | A | FALSE | 2 | Bellevue | false |
WA | B | FALSE | 2 | Bellevue | false |
WA | A | FALSE | 3 | Redmond | false |
WA | B | false | 1 | Redmond | false |
OR | C | FALSE | 3 | Portland | false |
WA | true | 4 | Bellevue | false | |
WA | true | 4 | Redmond | false | |
OR | true | 3 | Portland | false | |
A | false | 5 | FALSE | ||
B | FALSE | 3 | true | ||
C | FALSE | 3 | TRUE | ||
true | 11 | true |