SUMMARIZECOLUMNS

Artigo
12/17/2024

aplica-se a:coluna calculada tabela calculada Measure cálculo visual

Retorna uma tabela de resumo por um conjunto de grupos.

Sintaxe

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

Parâmetros

Termo	Definição
`groupBy_columnName`	Uma referência de coluna totalmente qualificada (Table[Column]) a uma tabela base para a qual os values distintos são incluídos na tabela retornada. Cada coluna groupBy_columnName é unida (tabelas diferentes) or existente automaticamente (mesma tabela) com as colunas especificadas subsequentes.
`filterTable`	Uma expressão de tabela que é adicionada ao contexto filter de colunas all especificadas como argumentos groupBy_columnName. Os values presentes na tabela filter são usados para filter antes que a junção cruzada/a existência automática seja executada.
`name`	Uma cadeia de caracteres que representa o nome da coluna a ser usada para a expressão posterior especificada.
`expression`	Qualquer expressão DAX que retorna um único value (not uma tabela).

Retornar value

Uma tabela que inclui combinações de values das colunas fornecidas com base no agrupamento especificado. Somente as linhas para as quais pelo menos uma das expressões fornecidas retornam uma nãoblankvalue são incluídas na tabela retornada. If all expressões evaluate a BLANK/NULL para uma linha, essa linha é not incluída na tabela retornada.

Comentários

Essa função not garante qualquer ordem de classificação para os resultados.
Não é possível especificar uma coluna mais de uma vez no parâmetro groupBy_columnName. Por exemplo, a fórmula a seguir é inválida.

SUMMARIZECOLUMNS( Sales[StoreId], Sales[StoreId] )
Essa função not tem suporte para uso no modo DirectQuery quando usada em colunas calculadas or regras de RLS (segurança em nível de linha).

Filter contexto

Considere a consulta a seguir:

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

Nesta consulta, sem um measure as colunas groupBynot contêm colunas da expressão FILTER (por exemplo, da tabela Cliente). O filter é not aplicado às colunas groupBy. As tabelas sales territory and Customer podem ser indiretamente related por meio da tabela fact de vendas do Revendedor. Como eles são not diretamente related, a expressão filter é uma no-op and as colunas groupBy são not afetadas.

No entanto, com esta consulta:

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

As colunas groupBy contêm uma coluna que é afetada pelo filterand que filter é aplicada aos resultados do groupBy.

Com IGNORE

A sintaxe IGNORE pode ser usada para modificar o comportamento da função SUMMARIZECOLUMNS omitindo expressões específicas da avaliação BLANK/NULL. As linhas para as quais as expressões allnot usando IGNORE retornam BLANK/NULL serão excluídas independentemente de as expressões que usam IGNOREevaluate para BLANK/NULL ornot. IGNORE só pode ser usado em uma expressão SUMMARIZECOLUMNS.

Exemplo

SUMMARIZECOLUMNS( 
    Sales[CustomerId], "Total Qty", 
    IGNORE( SUM( Sales[Qty] ) ), 
    "BlankIfTotalQtyIsNot3", IF( SUM( Sales[Qty] )=3, 3 ) 
)

Isso acumula a coluna Sales[CustomerId], criando um subtotal para all clientes no agrupamento determinado. Sem IGNORE, o resultado é:

CustomerId	Total Qty	BlankIfTotalQtyIsNot3
Um	5
B	3	3
C	3	3

Com IGNORE,

CustomerId	Total Qty	BlankIfTotalQtyIsNot3
B	3	3
C	3	3

All expressão ignorada,

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

Even embora ambas as expressões retornem blank para algumas linhas, elas são incluídas, pois não há expressões não independentes que retornem blank.

CustomerId	Blank	BlankIfTotalQtyIsNot5
Um		5
B
C

Com NONVISUAL

A função NONVISUAL marca um valuefilter na função SUMMARIZECOLUMNS como not afetando measurevalues, mas aplicando-se apenas a colunas groupBy. NONVISUAL só pode ser usado em uma expressão SUMMARIZECOLUMNS.

Exemplo

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]

Retorna o resultado em que [Visual Total Sales] é o total em all anos:

DimDate[CalendarYear]	[Vendas]	[Vendas Totais Visuais]
2007	9.791.060,30	29.358.677,22
2008	9.770.899,74	29.358.677,22

Por outro lado, a mesma consulta sem a função NONVISUAL:

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]

Retorna o resultado em que [Vendas Totais Visuais] é o total nos dois anos selecionados:

DimDate[CalendarYear]	[Vendas]	[Vendas Totais Visuais]
2007	9.791.060,30	19.561.960,04
2008	9.770.899,74	19.561.960,04

Com ROLLUPADDISSUBTOTAL

A adição da sintaxe ROLLUPADDISSUBTOTAL modifica o comportamento da função SUMMARIZECOLUMNS adicionando linhas rollup/subtotais ao resultado com base nas colunas groupBy_columnName. ROLLUPADDISSUBTOTAL só pode ser usado em uma expressão SUMMARIZECOLUMNS.

Exemplo com apenas um subtotal

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]

Retorna a tabela a seguir,

Categoria	Subcategoria	IsCategorySubtotal	IsSubcategorySubtotal	Total Qty
		True	True	60398
Acessórios		False	True	36092
Acessórios	Racks de bicicleta	False	False	328
Bikes	Mountain bikes	False	False	4970
Clothing		False	True	9101

Exemplo com vários subtotais

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

As vendas são agrupadas por estado, por cliente, por date, com subtotais para 1. Vendas por estado, por date 2. Vendas por estado, por cliente 3. Acumulado em ambos os anddate de clientes que levam a vendas por estado.

Retorna a tabela a seguir,

CustomerID	IsCustomerSubtotal	Estado	Total Qty	Date	IsDateSubtotal
Um	`FALSE`	WA	5	10/7/2014
B	`FALSE`	WA	1	10/7/2014
B	`FALSE`	WA	2	11/7/2014
C	`FALSE`	OR	2	10/7/2014
C	`FALSE`	OR	1	11/7/2014
	`TRUE`	WA	6	10/7/2014
	`TRUE`	WA	2	11/7/2014
	`TRUE`	OR	2	10/7/2014
	`TRUE`	OR	1	11/7/2014
Um	`FALSE`	WA	5		`TRUE`
B	`FALSE`	WA	3		`TRUE`
C	`FALSE`	OR	3		`TRUE`
	`TRUE`	WA	8		`TRUE`
	`TRUE`	OR	3		`TRUE`

Com ROLLUPGROUP

Assim como com a função SUMMARIZE, ROLLUPGROUP pode ser usado junto com ROLLUPADDISSUBTOTAL para especificar quais grupos de resumo/granularidades (subtotais) incluir, reduzindo o número de linhas subtotais retornadas. ROLLUPGROUP só pode ser usado em uma expressão SUMMARIZECOLUMNSorSUMMARIZE.

Exemplo com vários subtotais

SUMMARIZECOLUMNS( 
    ROLLUPADDISSUBTOTAL( Sales[CustomerId], "IsCustomerSubtotal" ), 
    ROLLUPADDISSUBTOTAL(ROLLUPGROUP(Regions[City], Regions[State]), "IsCityStateSubtotal"),"Total Qty", SUM( Sales[Qty] ) 
)

Ainda agrupado pelo City and State, mas enrolado ao relatar um subtotal retorna a tabela a seguir,

Estado	CustomerId	IsCustomerSubtotal	Total Qty	City	IsCityStateSubtotal
WA	Um	`FALSE`	2	Bellevue	`FALSE`
WA	B	`FALSE`	2	Bellevue	`FALSE`
WA	Um	`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`
	Um	`FALSE`	5		`FALSE`
	B	`FALSE`	3		`TRUE`
	C	`FALSE`	3		`TRUE`
		`TRUE`	11		`TRUE`

SummarizeColumns contextual

Tela de fundo

Até fevereiro de 2023, SUMMARIZECOLUMNSnot avaliação de suporte dentro de uma transição de contexto em all. Em produtos lançados antes desse month, essa limitação tornou SUMMARIZECOLUMNSnot útil na maioria das medidas – era not possível chamar um measureSUMMARIZECOLUMNS em qualquer caso de transição de contexto, incluindo outros SUMMARIZECOLUMNSstatements.

A partir de fevereiro de 2023, a transição de contexto tem suporte em alguns cenários, mas not em all as condições. Os casos and restritos com suporte são os seguintes:

Tipo de SummarizeColumns	Filter externos com uma única coluna	Filter externo com mais de uma coluna	Colunas de GroupBy externas
SummarizeColumns somente com GroupBy	OK	OK	OK
SummarizeColumns com Filters/Measures	OK	ERROR	ERROR

A partir de junho de 2024, estamos habilitando SummarizeColumns contextuais que permitem que SummarizeColumns sejam avaliados em qualquer transição de contexto, SummarizeColumns em measurenow é totalmente compatível:

Tipo de SummarizeColumns	Filter externos com uma única coluna	Filter externo com mais de uma coluna	Colunas de GroupBy externas
SummarizeColumns somente com GroupBy	OK	OK	OK
SummarizeColumns com Filters/Measures	OK	OK	OK

No entanto, essa atualização também inclui alterações no comportamento de SummarizeColumns, o que pode alterar os resultados das expressões existentes:

Semântica de SelfValue para filters externos

Estamos introduzindo um conceito semântico chamado SelfValue, que altera como filters de tabelas externas interagem com colunas GroupBy em SummarizeColumns. Essa alteração não permite que filters de uma tabela diferente afetem as colunas GroupBy, evenif as tabelas são related por meio de uma relação filterpor. Um exemplo que ilustra o impacto desta alteração envolve a seguinte expressão:

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

Antes dessa atualização, o TreatAsfilter se aplicaria à operação de GroupBy em SummarizeColumns, aproveitando a relação entre 'Product'[Product Key] and 'Vendas do Revendedor'[ProductKey]. Consequentemente, os resultados da consulta incluem apenas linhas em que "Vendas do Revendedor"[ProductKey] é igual a 229. No entanto, após a atualização, GroupBy colunas dentro de SummarizeColumns não serão mais filtradas por colunas de tabelas externas, evenif existe uma relação entre elas. Portanto, no exemplo acima, a coluna GroupBy 'Vendas do Revendedor'[ProductKey] not será filtrada pela coluna 'Product'[ProductKey]. Como resultado, a consulta incluirá linhas em que 'Vendas do Revendedor'[ProductKey] é not igual a 229.

If preferir manter o comportamento previous, você pode reescrever a expressão usando Summarize em vez de SummarizeColumns, conforme mostrado abaixo:

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

Essa expressão reescrita preserva a semântica original em que a operação de GroupBy é not afetada pela restrição SelfValue introduzida pela atualização.

Validação de linha para colunas groupby totalmente cobertas por Treatas

Antes dessa atualização, em uma função SummarizeColumns, ifallGroupBy colunas de uma tabela específica eram totalmente cobertas por uma única Treatasfilter da mesma tabela, conforme mostrado abaixo:

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

O resultado da consulta acima incluiria quaisquer linhas especificadas no Treatasfilter, independentemente de serem ornotválidas. Por exemplo, o resultado seria uma tabela de linha única ("Estados Unidos", "Alberta"), evenif nenhuma linha com [País] = "Estados Unidos" and [Estado] = "Alberta" existia na tabela 'Geography'.

Esse problema era conhecido and foi resolvido pela atualização. Após a atualização, essas linhas inválidas serão filtradas, and apenas linhas válidas da tabela GroupBy serão retornadas. Portanto, o resultado da consulta acima estaria vazio, pois não há linhas válidas que correspondam ao and [Estado] especificado values na tabela 'Geography'.

Não permitir Keepfilters/overriddefilters mistos na mesma tabela/cluster

A atualização recente introduziu uma restrição temporária que dispara uma mensagem error informando:

"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."

Essa error ocorre quando filters normais (que substituem filtersexistentes) andfilters com KeepFilters especificadas estão presentes na mesma tabela/cluster. Por exemplo:

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

Na expressão acima, há duas filters na tabela 'Geography': uma com KeepFilters especificada and uma sem. Essas filters se sobrepõem a filters externas em colunas diferentes. Atualmente, essa configuração é not permitida porque, internamente, os dois filters são clusterizados em um, and o sistema não pode determinar o comportamento correto de substituição filter para os filter clusterizados em geral nesses casos.

Observe que essa restrição é temporária. Estamos desenvolvendo ativamente soluções para remover essa limitação em atualizações futuras. If encontrar esse error, aconselhamos ajustar o filters dentro de SummarizeColumns adicionando or removendo KeepFilters conforme necessário para garantir um comportamento de substituição consistente em cada tabela.

SUMMARIZE

Compartilhar via

SUMMARIZECOLUMNS

Sintaxe

Parâmetros

Retornar value

Comentários

Filter contexto

Com IGNORE

Exemplo

Com NONVISUAL

Exemplo

Com ROLLUPADDISSUBTOTAL

Exemplo com apenas um subtotal

Exemplo com vários subtotais

Com ROLLUPGROUP

Exemplo com vários subtotais

SummarizeColumns contextual

Tela de fundo

Semântica de SelfValue para filters externos

Validação de linha para colunas groupby totalmente cobertas por Treatas

Não permitir Keepfilters/overriddefilters mistos na mesma tabela/cluster

Comentários

Recursos adicionais

Compartilhar via

SUMMARIZECOLUMNS

Sintaxe

Parâmetros

Retornar value

Comentários

Filter contexto

Com IGNORE

Exemplo

Com NONVISUAL

Exemplo

Com ROLLUPADDISSUBTOTAL

Exemplo com apenas um subtotal

Exemplo com vários subtotais

Com ROLLUPGROUP

Exemplo com vários subtotais

SummarizeColumns contextual

Tela de fundo

Semântica de SelfValue para filters externos

Validação de linha para colunas groupby totalmente cobertas por Treatas

Não permitir Keepfilters/overriddefilters mistos na mesma tabela/cluster

Related conteúdo

Comentários

Recursos adicionais