A função AGRUPARPOR permite que você crie um resumo dos seus dados por meio de uma fórmula. Ele suporta o agrupamento ao longo de um eixo e a agregação dos valores associados. Por exemplo, se você tiver uma tabela de dados de vendas, poderá gerar um resumo das vendas por ano.
Sintaxe
A função AGRUPARPOR permite agrupar, agregar, classificar e filtrar dados com base nos campos especificados.
A sintaxe da função AGRUPARPOR é:
AGRUPARPOR(campos_linha,valores,função,[cabeçalhos_campo],[profundidade_total],[ordem_classificação],[matriz_filtro],[relação_campo])
| Argumento | Descrição |
|---|---|
|
campos_linha (obrigatório) |
Uma matriz ou intervalo orientado a colunas que contém os valores usados para agrupar linhas e gerar cabeçalhos de linhas. A matriz ou intervalo pode conter várias colunas. Nesse caso, a saída terá vários níveis de grupo de linhas. |
|
valores (obrigatório) |
Uma matriz orientada por coluna ou intervalo dos dados a serem agregados. A matriz ou intervalo pode conter várias colunas. Nesse caso, a saída terá várias agregações. |
|
função (obrigatório) |
Um lambda explícito ou eta reduzido (SUM, PERCENTOF, AVERAGE, COUNT, etc.) que é usado para agregar valores. Um vetor de lambdas pode ser fornecido. Nesse caso, a saída terá várias agregações. A orientação do vetor determinará se eles são dispostos em linhas ou colunas. |
| cabeçalhos_campo | Um número que especifica se os campos_linha e valores têm cabeçalhos e se os cabeçalhos de campo devem ser retornados nos resultados. Os valores possíveis são: Ausente: Automático (padrão) 0: Não 1: Sim e não mostrar 2: Não, mas gerar 3: Sim e mostrar Observação: Automático assume que os dados contêm cabeçalhos com base no argumento values. Se o 1º valor for texto e o 2º valor for um número, presume-se que os dados tenham cabeçalhos. Os cabeçalhos dos campos são mostrados se houver vários níveis de grupo de linhas ou colunas. |
| profundidade_total | Determina se os cabeçalhos de linha devem conter totais. Os valores possíveis são: Ausente: automático: totais gerais e, sempre que possível, subtotais (padrão) 0: Nenhum total 1: Totais Gerais 2: Geral e Subtotais -1: Totais gerais no topo -2: Grand e Subtotais no topo Observação: Para subtotais, os campos devem ter pelo menos 2 colunas. Números maiores que 2 são suportados, desde que o campo tenha colunas suficientes. |
| ordem_classificação | Um número que indica como as linhas devem ser classificadas. Os números correspondem às colunas em campos_linha seguidas pelas colunas em valores. Se o número for negativo, as linhas são classificadas em ordem decrescente/inversa. Um vetor de números pode ser fornecido ao classificar com base apenas em campos_linha. |
| matriz_filtro | Uma matriz 1D orientada por coluna de booleanos que indica se a linha de dados correspondente deve ser considerada. Observação: o tamanho da matriz deve corresponder ao tamanho daquelas fornecidas para campos_linha. |
| relação_campo | Especifica os campos de relação quando várias colunas são fornecidas para campos_linha. Os valores possíveis são: 0: Hierarquia (padrão) 1: Tabela Com um relacionamento de campo de hierarquia (0), a classificação das colunas de campo posteriores leva em conta a hierarquia das colunas anteriores. Com uma relação de campo de tabela (1), a classificação de cada coluna de campo é feita de forma independente. Não há suporte para subtotais, pois dependem dos dados terem uma hierarquia. |
Exemplos
Exemplo 1: use GROUPBY para gerar um resumo do total de vendas por ano.
Exemplo 2: use GROUPBY para gerar um resumo do total de vendas por produto. Classificar em ordem decrescente por vendas.