SUMMARIZECOLUMNS 函数（DAX） - DAX

相关文章推荐
寂寞的筷子 · 广东法院涉高空抛物、坠物十大典型案例_广东法院网· 8 月前 ·
失恋的滑板 · 什么是板块边界？ - 知乎· 1 年前 ·
含蓄的书签 · 错过后悔系列|2020超好用软件盘点 - 知乎· 1 年前 ·
不拘小节的牛排 · 混的“最惨的”8个合资车企，随时退出中国市场 ...· 1 年前 ·
任性的火车 · 3本关于中世纪欧洲的架空历史小说-骑士之王， ...· 1 年前 ·
返回一组组的摘要表。
SUMMARIZECOLUMNS( <groupBy_columnName> [, < groupBy_columnName >]…, [<filterTable>]…[, <name>, <expression>]…)
parameters
groupBy_columnName
对基表的完全限定列引用（Table[Column]），返回的表中包括非重复值。 每个groupBy_columnName列都与后续指定的列交叉联接（不同表）或自动存在（同一表）。
filterTable
添加到指定为groupBy_columnName参数的所有列的筛选器上下文中的表表达式。 筛选器表中存在的值用于在执行交叉联接/自动存在之前进行筛选。
表示要用于指定的后续表达式的列名称的字符串。
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
    Sales[CustomerId], "Blank", 
    IGNORE( BLANK() ), "BlankIfTotalQtyIsNot5", 
    IGNORE( IF( SUM( Sales[Qty] )=5, 5 ) ) 
即使这两个表达式都为某些行返回空白，但它们也包括在内，因为没有返回空的未对齐表达式。
CustomerId
BlankIfTotalQtyIsNot5
              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]
[销售额]
[直观总销售额]
相比之下，没有  函数的同一查询 ：
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]
[销售额]
[直观总销售额]
使用 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
有多个小计的示例
SUMMARIZECOLUMNS ( 
    Regions[State], ROLLUPADDISSUBTOTAL ( Sales[CustomerId], "IsCustomerSubtotal" ), 
    ROLLUPADDISSUBTOTAL ( Sales[Date], "IsDateSubtotal"), "Total Qty", SUM( Sales[Qty] ) 
销售额按状态、按客户分组，按日期分组，分类汇总为 1。 按状态（按日期 2） 的销售额。 按州省/自治区/直辖市、按客户所得销售额 3. 按状态汇总到客户和日期。
返回下表，
CustomerID
IsCustomerSubtotal
IsDateSubtotal
使用 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
上下文 SummarizeColumns
直到 2023 年 2 月，SUMMARIZECOLUMNS 根本不支持上下文转换中的评估。 在该月之前发布的产品中，这种限制 SUMMARIZECOLUMNS 在大多数度量值中没有用处，在任何上下文转换（包括其他 SUMMARIZECOLUMNS 语句）中都不可能调用度量值 SUMMARIZECOLUMNS。
从 2023 年 2 月开始，在一些方案中支持上下文转换，但并非所有情况下都支持上下文转换。 支持和受限制的情况如下所示：
SummarizeColumns 类型
具有单列的外部筛选器
具有多个列的外部筛选器
外部 GroupBy 列
但是，此更新还包括对 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