SUMMARIZE

返回一个摘要表，显示对一组函数的请求总数。

语法

SUMMARIZE (<table>, <groupBy_columnName>[, <groupBy_columnName>]…[, <name>, <expression>]…)

parameters

返回值

一个表，其中包含 groupBy_columnName 参数的选定列，以及名称参数设计的汇总列 。

备注

• 为其定义名称的每个列都必须具有一个对应的表达式；否则，将返回错误。 第一个参数 name 定义结果中列的名称。 第二个参数 expression 定义为获取该列中每一行的值进行的计算。

• groupBy_columnName 必须位于表中，或位于与表相关的表中 。

• 每个名称都必须用双引号引起来。

• 函数根据一个或多个 groupBy_columnName 列的值将一组选定的行归组为一组摘要行。 为每个组返回一行。

• 在已计算的列或行级安全性 (RLS) 规则中使用时，不支持在 DirectQuery 模式下使用此函数。

示例

下面的示例返回按日历年和产品类别名称分组的经销商销售额的摘要，通过此结果表可以按年份和产品类别分析经销商销售额。

SUMMARIZE(ResellerSales_USD        , DateTime[CalendarYear]        , ProductCategory[ProductCategoryName]        , "Sales Amount (USD)", SUM(ResellerSales_USD[SalesAmount_USD])        , "Discount Amount (USD)", SUM(ResellerSales_USD[DiscountAmount])        )  

下表显示了数据预览，该数据将由预期应接收表的任何函数接收：

使用 ROLLUP

添加 ROLLUP 语法后，通过将汇总行添加到 groupBy_columnName 列的结果中来修改 SUMMARIZE 函数的行为。 ROLLUP 只能在 SUMMARIZE 表达式中使用。

示例

下面的示例向 SUMMARIZE 函数调用的 Group-By 列添加汇总行：

SUMMARIZE(ResellerSales_USD        , ROLLUP( DateTime[CalendarYear], ProductCategory[ProductCategoryName])        , "Sales Amount (USD)", SUM(ResellerSales_USD[SalesAmount_USD])        , "Discount Amount (USD)", SUM(ResellerSales_USD[DiscountAmount])  )  

返回下表，

使用 ROLLUPGROUP

向 ROLLUP 语法中添加 ROLLUPGROUP 可用于防止汇总行中出现部分小计。 ROLLUPGROUP 只能在 ROLLUP、ROLLUPADDISSUBTOTAL 或 ROLLUPISSUBTOTAL 表达式内使用。

示例

以下示例仅显示所有年份和类别的总计，而不显示所有类别的每年的小计：

SUMMARIZE(ResellerSales_USD        , ROLLUP(ROLLUPGROUP( DateTime[CalendarYear], ProductCategory[ProductCategoryName]))        , "Sales Amount (USD)", SUM(ResellerSales_USD[SalesAmount_USD])        , "Discount Amount (USD)", SUM(ResellerSales_USD[DiscountAmount])  )  

返回下表，

使用 ISSUBTOTAL

使用 ISSUBTOTAL，你可以在 SUMMARIZE 表达式中创建另一列，如果该行包含给定为 ISSUBTOTAL 参数的列的小计值，则返回 True，否则返回 False。 ISSUBTOTAL 只能在 SUMMARIZE 表达式中使用。

示例

下面的示例为 SUMMARIZE() 函数调用中的每个 ROLLUP 列生成一个 ISSUBTOTAL 列：

SUMMARIZE(ResellerSales_USD        , ROLLUP( DateTime[CalendarYear], ProductCategory[ProductCategoryName])        , "Sales Amount (USD)", SUM(ResellerSales_USD[SalesAmount_USD])        , "Discount Amount (USD)", SUM(ResellerSales_USD[DiscountAmount])        , "Is Sub Total for DateTimeCalendarYear", ISSUBTOTAL(DateTime[CalendarYear])        , "Is Sub Total for ProductCategoryName", ISSUBTOTAL(ProductCategory[ProductCategoryName])  )  

返回下表，

请参阅

SUMMARIZECOLUMNS