Summarize Função

Aplica-se a: Copilot Studio Desktop flui Power Platform CLI Dataverse funções

Summarize registros de uma tabela agrupando em uma ou mais colunas.

Description

Use a Summarize função para agrupar registros de uma tabela e resumir as colunas no grupo.

O primeiro argumento é a tabela para Summarize operar. Os restantes argumentos podem estar em qualquer ordem e enquadrar-se em duas categorias:

• Nomes de colunas de grupo. Use-os para especificar em quais colunas agrupar.
• Fórmulas de sumarização. Use-os para resumir as colunas na tabela ThisGroup . ThisGroup é uma tabela que contém todas as colunas da tabela original, mas é limitada apenas aos registros de um grupo de cada vez com base nas colunas do grupo. Cada fórmula deve ser nomeada com As for column name na tabela de resultados.

Uma tabela é um valor no Power Apps, tal como uma cadeia ou um número. Pode especificar uma tabela como um argumento para uma função e uma função pode devolver uma tabela. Summarize não modifica uma tabela; em vez disso, ele usa uma tabela como um argumento e retorna uma tabela diferente. Para mais informações, consulte trabalhar com tabelas.

Delegação

Summarize pode ser delegada dependendo da fonte de dados e da complexidade das fórmulas de sumarização. Funções agregadas básicas, como Sum, Average, Max, Min, CountRows, e Concat têm uma boa chance de serem delegadas.

Se a delegação completa de uma fórmula não for possível, o ambiente de criação sinalizará a parte que não pode ser delegada com um aviso. Sempre que possível, considere alterar a fórmula para evitar funções e operadores que não podem ser delegados.

Para obter mais informações, consulte Visão geral da delegação.

Sintaxe

Summarize( Tabela, GroupByColumnName1 [, GroupByColumnName2, ... ] [, SummarizeColumns como SummarizeNames, ...] )

• Tabela - Obrigatório. Quadro a resumir.
• GroupByColumnNames - Pelo menos um é necessário. Os nomes das colunas na Tabela através da qual os registos são agrupados. Estas colunas tornam-se colunas na tabela resultante.
• SummarizeColumns - Opcional. Fórmula de resumo sobre a tabela ThisGroup para cada grupo.
• SummarizeNames - Obrigatório para cada SummarizeColumn. Cada coluna resumida deve ser explicitamente nomeada para a tabela de saída.

Exemplos

Exemplo simples

1. Crie uma tabela em seu Power Fx host com estes dados de exemplo:

Set( CityPopulations,
   Table(
        { City: "London",    Country: "United Kingdom", Population: 8615000},
        { City: "Berlin",    Country: "Germany",        Population: 3562000},
        { City: "Madrid",    Country: "Spain",          Population: 3165000},
        { City: "Rome",      Country: "Italy",          Population: 2874000},
        { City: "Paris",     Country: "France",         Population: 2273000},
        { City: "Hamburg",   Country: "Germany",        Population: 1760000},
        { City: "Barcelona", Country: "Spain",          Population: 1602000},
        { City: "Munich",    Country: "Germany",        Population: 1494000},
        { City: "Milan",     Country: "Italy",          Population: 1344000}
    )
)

2. Avalie a seguinte fórmula:

Summarize( CityPopulations, Country,
           Sum( ThisGroup, Population ) As 'Total Population',
           Concat( ThisGroup, City, ", " ) As Cities 
)

O resultado é esta tabela:

Várias colunas de grupo

1. Crie uma tabela em seu Power Fx host com estes dados de exemplo:

Set( Inventory, 
   Table(
      {Supplier:"Contoso",  Fruit:"Grapes",  Price:220, Purchase:Date(2015,10,1), Tags: ["Red","Seedless"]},
      {Supplier:"Fabrikam", Fruit:"Lemons",  Price:31,  Purchase:Date(2015,10,1), Tags: ["Colombia"]},
      {Supplier:"Contoso",  Fruit:"Lemons",  Price:29,  Purchase:Date(2015,10,2), Tags: ["Peru"]},
      {Supplier:"Contoso",  Fruit:"Grapes",  Price:210, Purchase:Date(2015,10,2), Tags: ["Green","Seedless"]},
      {Supplier:"Fabrikam", Fruit:"Lemons",  Price:30,  Purchase:Date(2015,10,3), Tags: ["Mexico","Seedless"]},
      {Supplier:"Contoso",  Fruit:"Bananas", Price:12,  Purchase:Date(2015,10,3), Tags: ["Mexico"]}
   )
)

2. Avalie a seguinte fórmula:

Summarize( Inventory, Supplier, Fruit, Average( ThisGroup, Price ) As 'Average Price' )