O AGRUPARPOR function permite que você crie um resumo de seus dados por meio de uma fórmula. Ele dá suporte ao agrupamento ao longo de um eixo e 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(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 para colunas que contém os valores usados para agrupar linhas e gerar cabeçalhos de linha. A matriz ou o intervalo podem conter várias colunas. Nesse caso, a saída terá vários níveis de grupo de linhas. |
|
values (obrigatório) |
Uma matriz ou intervalo orientado para colunas dos dados a serem agregados. A matriz ou o intervalo podem conter várias colunas. Nesse caso, a saída terá várias agregações. |
|
função (obrigatório) |
Uma lambda explícita ou eta reduzida (SUM, PORCENTAGEMDE, AVERAGE, COUNT etc.) usada 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 definidos em linha ou em coluna. |
|
field_headers |
Um número que especifica se os valores erow_fields 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º 1: Sim e não mostrar 2: Não, mas gerar3: Sim e mostrar Observação: Assume automaticamente que os dados contêm cabeçalhos com base no argumento de valores. Se o 1º valor for texto e o 2º valor for um número, os dados deverão ter cabeçalhos. Os cabeçalhos de campos são mostrados se houver vários níveis de linha ou grupo de colunas. |
|
total_depth |
Determina se os cabeçalhos de linha devem conter totais. Os valores possíveis são: Ausente: Automático: Totais grandes e, sempre que possível, subtotais (padrão)0: Sem Totais1: Grandes Totais2: Grand e Subtotals-1: Grandes Totais no Top-2: Grand e Subtotals no Topo Observação: Para subtotais, os campos devem ter pelo menos duas colunas. Há suporte para números maiores que 2, 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 seguidas pelas colunas em valores. Se o número for negativo, as linhas serão classificadas em ordem descendente/reversa. Um vetor de números pode ser fornecido ao classificar com base apenas em row_fields. |
|
filter_array |
Uma matriz 1D orientada à coluna de boolianos que indica se a linha de dados correspondente deve ser considerada. Observação: O comprimento da matriz deve corresponder ao comprimento dos fornecidos para row_fields. |
|
field_relationship |
Especifica os campos de relação quando várias colunas são fornecidas para row_fields. Os valores possíveis são: 0: Hierarquia (padrão)1: Tabela Com uma relação de campo Hierarquia (0), a classificação de colunas de campo posteriores leva em conta a hierarquia de colunas anteriores. Com uma relação de campo tabela (1), a classificação de cada coluna de campo é feita de forma independente. Não há suporte para subtotais, pois eles dependem dos dados que têm uma hierarquia. |
Exemplos
Exemplo 1: use AGRUPARPOR para gerar um resumo do total de vendas por ano.
Exemplo 2: use AGRUPARPOR para gerar um resumo do total de vendas por produto. Classificação decrescente por vendas.
