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 é:
GROUPBY(row_fields,values,function,[field_headers],[total_depth],[sort_order],[filter_array],[field_relationship])
| Argumento | Descrição |
|---|---|
|
row_fields (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. |
| field_headers | Um número que especifica se os row_fields 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. |
| total_depth | 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. |
| sort_order | Um número que indica como as linhas devem ser classificadas. Os números correspondem às colunas em row_fields seguidos 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 row_fields. |
| filter_array | Uma matriz 1D orientada por coluna de booleanos que indica se a linha de dados correspondente deve ser considerada. Observação: O comprimento da matriz deve corresponder ao comprimento daqueles fornecidos aos row_fields. |
| field_relationship | Especifica os campos de relação quando várias colunas são fornecidas a row_fields. 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.
