Pular para o conteúdo
officetuning.aiofficetuning.ai
TreinamentosConsultoriaBibliotecaFerramentasConteúdoPortfólio
Entrar
officetuning.aiofficetuning.ai

Treinamento, consultoria e mentoria para decidir, construir e aprender nas quatro frentes da marca.

AI · Data · Productivity · Dev · São Paulo
contato@officetuning.ai
TreinamentosPower BIExcelSQLPowerPointIA + ProdutividadeTodos os treinamentos
PortalConsultoriaBibliotecaPortfólioBackground BuilderDashboard CanvasConteúdo
InstitucionalPolítica de privacidadeInformações legais
© 2026 officetuning.ai · São Paulo
  1. Biblioteca
  2. Power Query (M)
  3. Funções M
  4. Table.Group

Table.Group

MTabela

Agrupa as linhas de table pelas colunas-chave definidas em key, que pode ser um único nome de coluna ou uma lista de nomes. Para cada grupo, cria um registro com as colunas-chave (e seus valores) e as colunas agregadas definidas em aggregatedColumns. Opcionalmente, groupKind e comparer podem ser informados.

Sintaxe

M
Table.Group(table as table, key as any, aggregatedColumns as list, optional groupKind as nullable number, optional comparer as nullable function) as table

Parâmetros

tabletableObrigatório

Tabela de entrada.

M
Table.FromRecords({...})
keyanyObrigatório

Nome ou lista de nomes das colunas-chave do agrupamento.

M
"CustomerID"
aggregatedColumnslistObrigatório

Colunas agregadas a criar para cada grupo.

M
{"total", each List.Sum([price])}
groupKindnullable numberOpcional

Tipo de agrupamento (GroupKind.Global ou GroupKind.Local).

comparernullable functionOpcional

Função de comparação das chaves.

Retorna

table

Exemplo

M
Table.Group(
    Table.FromRecords({
        [CustomerID = 1, price = 20],
        [CustomerID = 2, price = 10],
        [CustomerID = 2, price = 20],
        [CustomerID = 1, price = 10],
        [CustomerID = 3, price = 20],
        [CustomerID = 3, price = 5]
    }),
    "CustomerID",
    {"total", each List.Sum([price])}
)

Resultado

M
Table.FromRecords(
    {
        [CustomerID = 1, total = 30],
        [CustomerID = 2, total = 30],
        [CustomerID = 3, total = 25]
    },
    {"CustomerID", "total"}
)

Observações

Se os dados já estiverem ordenados pelas colunas-chave, GroupKind.Local pode melhorar o desempenho, pois assume que linhas com a mesma chave são contíguas. Se o comparer tratar chaves diferentes como iguais, uma linha pode cair em um grupo cujas chaves diferem das suas. Não garante a ordem das linhas retornadas.

Mais informações

Subgrupo
Table
Referência
https://learn.microsoft.com/pt-br/powerquery-m/table-group
Função anteriorTable.FuzzyNestedJoinPróxima função Table.HasColumns
Biblioteca