SUMMARIZECOLUMNS

项目
01/23/2025

返回一组组的摘要表。

语法

SUMMARIZECOLUMNS( <groupBy_columnName> [, < groupBy_columnName >]…, [<filterTable>]…[, <name>, <expression>]…)

parameters

术语	定义
`groupBy_columnName`	对基表的完全限定列引用（Table[Column]），返回的表中包括非重复值。每个groupBy_columnName列都与后续指定的列交叉联接（不同表）或自动存在（同一表）。
`filterTable`	添加到指定为groupBy_columnName参数的所有列的筛选器上下文中的表表达式。筛选器表中存在的值用于在执行交叉联接/自动存在之前进行筛选。
`name`	表示要用于指定的后续表达式的列名称的字符串。
`expression`	返回单个值（而不是表）的任何 DAX 表达式。

返回值

一个表，其中包含根据指定的分组从提供的列的值组合。只有至少一个提供的表达式返回非空值的行才会包含在返回的表中。如果所有表达式的计算结果为行的 BLANK/NULL，则该行不包含在返回的表中。

备注

此函数不保证结果的任何排序顺序。
不能在 groupBy_columnName 参数中多次指定某一列。例如，下面的公式无效。

SUMMARIZECOLUMNS( Sales[StoreId], Sales[StoreId] )
在计算列或行级别安全性（RLS）规则中使用时，不支持在 DirectQuery 模式下使用此函数。

筛选器上下文

请考虑下列查询：

SUMMARIZECOLUMNS ( 
    'Sales Territory'[Category], 
    FILTER('Customer', 'Customer' [First Name] = "Alicia") 
)

在此查询中，如果没有度量值，groupBy 列不包含 FILTER 表达式中的任何列（例如，来自 Customer 表）。筛选器不应用于 groupBy 列。销售区域和客户表可以通过经销商销售事实表间接相关。由于它们不直接相关，因此筛选器表达式是 no-op，groupBy 列不会受到影响。

但是，对于以下查询：

SUMMARIZECOLUMNS ( 
    'Sales Territory'[Category], 'Customer' [Education], 
    FILTER('Customer', 'Customer'[First Name] = "Alicia") 
)

groupBy 列包含一个受筛选器影响的列，该筛选器应用于 groupBy 结果。

使用 IGNORE

IGNORE 语法可用于通过省略 SUMMARIZECOLUMNS/NULL 计算中的特定表达式来修改 BLANK 函数的行为。不使用 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	总数量	BlankIfTotalQtyIsNot3
A	5
B	3	3
C	3	3

使用 IGNORE，

CustomerId	总数量	BlankIfTotalQtyIsNot3
B	3	3
C	3	3

忽略所有表达式，

SUMMARIZECOLUMNS( 
    Sales[CustomerId], "Blank", 
    IGNORE( BLANK() ), "BlankIfTotalQtyIsNot5", 
    IGNORE( IF( SUM( Sales[Qty] )=5, 5 ) ) 
)

即使这两个表达式都为某些行返回空白，但它们也包括在内，因为没有返回空的未对齐表达式。

CustomerId	空白	BlankIfTotalQtyIsNot5
A		5
B
C

使用 NONVISUAL

NONVISUAL 函数将 SUMMARIZECOLUMNS 函数中的值筛选器标记为不影响度量值，但仅适用于 groupBy 列。 NONVISUAL 只能在 SUMMARIZECOLUMNS 表达式中使用。

示例

DEFINE
MEASURE FactInternetSales[Sales] = SUM(FactInternetSales[Sales Amount])
EVALUATE
SUMMARIZECOLUMNS
(
    DimDate[CalendarYear],
    NONVISUAL(TREATAS({2007, 2008}, DimDate[CalendarYear])),
    "Sales", [Sales],
    "Visual Total Sales", CALCULATE([Sales], ALLSELECTED(DimDate[CalendarYear]))
)
ORDER BY [CalendarYear]

返回结果，其中 [Visual Total Sales] 是所有年份的总和：

DimDate[CalendarYear]	[销售额]	[直观总销售额]
2007	9,791,060.30	29,358,677.22
2008	9,770,899.74	29,358,677.22

相比之下，没有函数的同一查询：

DEFINE
MEASURE FactInternetSales[Sales] = SUM(FactInternetSales[Sales Amount])
EVALUATE
SUMMARIZECOLUMNS
(
    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 表达式中使用。

有单个小计的示例

DEFINE
VAR 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	总数量
		真	真	60398
Accessories		假	真	36092
Accessories	自行车车架	假	假	328
Bikes	山地自行车	假	假	4970
Clothing		假	真	9101

有多个小计的示例

SUMMARIZECOLUMNS ( 
    Regions[State], ROLLUPADDISSUBTOTAL ( Sales[CustomerId], "IsCustomerSubtotal" ), 
    ROLLUPADDISSUBTOTAL ( Sales[Date], "IsDateSubtotal"), "Total Qty", SUM( Sales[Qty] ) 
)

销售额按状态、按客户分组，按日期分组，分类汇总为 1。按状态（按日期 2）的销售额。按州省/自治区/直辖市、按客户所得销售额 3. 按状态汇总到客户和日期。

返回下表，

CustomerID	IsCustomerSubtotal	状态	总数量	日期	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`

上下文 SummarizeColumns

背景

直到 2023 年 2 月，SUMMARIZECOLUMNS 根本不支持上下文转换中的评估。在该月之前发布的产品中，这种限制 SUMMARIZECOLUMNS 在大多数度量值中没有用处，在任何上下文转换（包括其他 SUMMARIZECOLUMNS 语句）中都不可能调用度量值 SUMMARIZECOLUMNS。

从 2023 年 2 月开始，在一些方案中支持上下文转换，但并非所有情况下都支持上下文转换。支持和受限制的情况如下所示：

SummarizeColumns 类型	具有单列的外部筛选器	具有多个列的外部筛选器	外部 GroupBy 列
仅限 GroupBy 的 SummarizeColumns	OK	OK	OK
包含筛选器/度量值的 SummarizeColumns	OK	ERROR	ERROR

从 2024 年 6 月开始，我们启用上下文 SummarizeColumns，允许在任何上下文转换中评估 SummarizeColumns，现在完全支持 SummarizeColumns 度量值：

SummarizeColumns 类型	具有单列的外部筛选器	具有多个列的外部筛选器	外部 GroupBy 列
仅限 GroupBy 的 SummarizeColumns	OK	OK	OK
包含筛选器/度量值的 SummarizeColumns	OK	OK	OK

但是，此更新还包括对 SummarizeColumns 行为所做的更改，这可能会更改现有表达式的结果：

外部筛选器的 SelfValue 语义

我们引入了一个名为 SelfValue 的语义概念，该概念改变了来自外部表的筛选器如何与 SummarizeColumns 中的 GroupBy 列交互。此更改禁止来自其他表的筛选器，以影响 GroupBy 列，即使这些表通过筛选关系相关也是如此。演示此更改影响的一个示例涉及以下表达式：

CalculateTable(
  SummarizeColumns(
      'Reseller Sales'[ResellerKey], 
      'Reseller Sales'[ProductKey]
  ), 
  Treatas({(229)}, 'Product'[Product Key])
)

在此更新之前，TreatAs 筛选器将应用于 SummarizeColumns 中的 GroupBy 操作，并利用“Product”[Product Key] 和“Reseller Sales”[ProductKey]之间的关系。因此，查询结果将仅包含 'Reseller Sales'[ProductKey] 等于 229 的行。但是，更新后，SummarizeColumns 中的 GroupBy 列将不再按外部表中的列进行筛选，即使它们之间存在关系也是如此。因此，在上面的示例中，GroupBy 列“Reseller Sales”[ProductKey] 将不会按“Product”[ProductKey] 列进行筛选。因此，查询将包含“Reseller Sales”[ProductKey] 不等于 229 的行。

如果希望保留以前的行为，可以使用 Summarize 而不是 SummarizeColumns 重写表达式，如下所示：

CalculateTable(
    SUMMARIZE(
        'Reseller Sales',
        [ResellerKey],
        [ProductKey]
    ),
    Treatas({(229)}, 'Product'[Product Key])
)

此重写表达式保留原始语义，其中 GroupBy 操作不受更新引入的 SelfValue 限制的影响。

Treatas 完全涵盖的 groupby 列的行验证

在此更新之前，在 SummarizeColumns 函数中，如果特定表中的所有 GroupBy 列都完全由同一表中的单个 Treatas 筛选器覆盖，如下所示：

SummarizeColumns(
  Geography[Country], 
  Geography[State], 
  Treatas(
      {("United States", "Alberta")}, 
      Geography[Country], 
      Geography[State]
  )
)

上述查询的结果将包括 Treatas 筛选器中指定的任何行，无论它们是否有效。例如，结果将是单行表（“美国”、“艾伯塔”），即使 “Country] = ”United States“ 和 [State] = ”Alberta“ 的此类行也不存在于”Geography“表中。

此问题已知且已由更新解决。更新后，将筛选出此类无效行，并且仅返回 GroupBy 表中的有效行。因此，上述查询的结果将为空，因为“Geography”表中没有与指定的 [Country] 和 [State] 值匹配的有效行。

禁止同一表/群集上的混合 Keepfilters/overriddefilters

最近的更新引入了一个临时限制，用于触发错误消息，指出：

"SummarizeColumns filters with keepfilters behavior and overridefilters behavior are mixed within one cluster, which is not allowed. Consider adding keepfilters() to all filters of summarizecolumns."

当普通筛选器（替代现有筛选器）和具有 KeepFilters 的筛选器都存在于同一表/群集中时，会出现此错误。例如：

Evaluate CalculateTable(
  SummarizeColumns(
      Product[Color],
      KeepFilters(
          TreatAs(
              {( "Washington")}
              , Geography[State]
          )
      ),
      TreatAs(
          {("United States"), ("Canada")}
          , Geography[Country]
      )
  )
  ,TreatAs({("Alberta")}, Geography[State])
  ,TreatAs({("Canada")}, Geography[Country])
)

在上述表达式中，“Geography”表上有两个筛选器：一个筛选器指定了 KeepFilters，另一个没有。这些筛选器与不同列上的外部筛选器重叠。目前，不允许此配置，因为内部将两个筛选器聚集到一个筛选器中，并且系统无法确定此类情况下群集筛选器的整体正确替代行为。

请注意，此限制是暂时性的。我们正在积极开发解决方案，以便在将来的更新中消除此限制。如果遇到此错误，我们建议根据需要添加或删除 KeepFilters 来调整 SummarizeColumns 中的筛选器，以确保对每个表执行一致的重写行为。

SUMMARIZE

通过

SUMMARIZECOLUMNS

语法

parameters

返回值

备注

筛选器上下文

使用 IGNORE

示例

使用 NONVISUAL

示例

使用 ROLLUPADDISSUBTOTAL

有单个小计的示例

有多个小计的示例

使用 ROLLUPGROUP

有多个小计的示例

上下文 SummarizeColumns

背景

外部筛选器的 SelfValue 语义

Treatas 完全涵盖的 groupby 列的行验证

禁止同一表/群集上的混合 Keepfilters/overriddefilters

反馈

其他资源

通过

SUMMARIZECOLUMNS

语法

parameters

返回值

备注

筛选器上下文

使用 IGNORE

示例

使用 NONVISUAL

示例

使用 ROLLUPADDISSUBTOTAL

有单个小计的示例

有多个小计的示例

使用 ROLLUPGROUP

有多个小计的示例

上下文 SummarizeColumns

背景

外部筛选器的 SelfValue 语义

Treatas 完全涵盖的 groupby 列的行验证

禁止同一表/群集上的混合 Keepfilters/overriddefilters

相关内容

反馈

其他资源