Above() avalia uma expressão na linha acima da linha atual dentro de um segmento de coluna em uma tabela. A linha para a qual ela é calculada depende do valor de offset; se estiver presente, o padrão será a linha diretamente acima. Para gráficos que não sejam tabelas, Above() avalia a linha acima da linha atual, na tabela estática equivalente do gráfico.
Sintaxe:
Above([TOTAL] expr [ , offset [,count]])
Tipo de dados de retorno: dual
| Argumento | Descrição |
|---|---|
| expr | A expressão ou campo que contém os dados a serem medidos. |
| offset | Especificar um offset n, maior que 0 move a avaliação da expressão n para linhas acima da linha atual. A especificação de um deslocamento igual a 0 avaliará a expressão na linha atual. Especificando um número de compensação negativa faz a função Above funcionar como a função Below com o número de compensação positiva correspondente. |
| count | Ao especificar um terceiro argumento count maior que 1, a função retornará uma série de valores count, um para cada linha da tabela count, contado para cima a partir da célula original. Dessa forma, a função pode ser usada como um argumento para qualquer uma das funções de intervalo especiais. Funções de intervalo |
| TOTAL | Se a tabela for unidimensional ou se o qualificador TOTAL for usado como argumento, o segmento de coluna atual será sempre igual à coluna inteira. |
Na primeira linha de um segmento de coluna, um valor NULL é retornado, já que não há uma linha acima dela.
Limitações:
-
As chamadas recursivas retornarão NULL.
-
A classificação por valores y em gráficos ou por colunas de expressão em tabelas não é permitida quando essa função de gráfico é usada em qualquer uma das expressões do gráfico. Essas alternativas de classificação estão, portanto, automaticamente desabilitadas. Quando você usar essa função de gráfico em uma visualização ou tabela, a classificação da visualização será revertida para a entrada classificada dessa função.
| Exemplo | Resultado |
|---|---|
|
Above( Sum(Sales) ) |
Retorna o valor de Sales para a linha acima da linha atual. |
Exemplo - Fundamentos de Above
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
-
Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
-
Os campos a seguir na tabela de dados:
-
Year
-
Sales
-
Script de carregamento
Example:
LOAD * INLINE [
Year, Sales
2019, 1000
2020, 1500
2021, 1200
2022, 1800
2023, 1700
];Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:
-
Year
Crie as seguintes medidas:
-
=Sum(Sales) para encontrar as vendas anuais.
-
=Above(Sum(Sales)) para encontrar o valor de vendas do ano anterior.
-
=Sum(Sales) - Above(Sum(Sales)) para calcular a variação entre o valor de Sales do ano atual e o valor do ano anterior.
-
=RangeSum(Above(Sales, 1, 2)) para demonstrar uma agregação de dois anos consecutivos dos dois anos anteriores de vendas.
-
=(Sales - Above(Sales)) / Above(Sales) para retornar a alteração em Sales como uma razão/porcentagem. Para mostrar esse valor como uma porcentagem, em Formatação de números, selecione Número > Formatação simples > 12,34%.
| Year | Sum(Sales) | Above(Sum(Sales)) | Sum(Sales) - Above(Sum(Sales)) | RangeSum(Above(Sales, 1, 2) | (Sales - Above(Sales)) / Above(Sales) |
|---|---|---|---|---|---|
| Totals | 7200 | - | - | 0 | - |
| 2019 | 1000 | - | - | 0 | - |
| 2020 | 1500 | 1000 | 500 | 1000 | 50.00% |
| 2021 | 1200 | 1500 | -300 | 2500 | -20.00% |
| 2022 | 1800 | 1200 | 600 | 2700 | 50.00% |
| 2023 | 1700 | 1800 | -100 | 3000 | -5.56% |
Observando os resultados, você pode comparar os valores de Sales no período atual com o período anterior.
-
A medida Sum(Sales)- Above(Sum(Sales)) retorna a alteração nos valores de Sales, comparando o período atual com o período anterior.
-
A medida RangeSum(Above(Sales, 1, 2)) retorna a soma dos dois valores Sales anteriores.
-
A medida (Sales - Above(Sales)) / Above(Sales) retorna a alteração em Sales em comparação com o período anterior como uma porcentagem.
Faça o seguinte:
Crie um gráfico de barras e adicione este campo como uma dimensão:
-
Year
Crie a seguinte medida:
-
=Sum(Sales) - Above(Sum(Sales)) para retornar a variação ano a ano.
Gráfico de barras mostrando os resultados da função Above
O uso da função Above em um gráfico de barras fornece uma comparação visual da variação entre as vendas do período atual e do período anterior.
Exemplo - Cenário de Above
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
-
Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
-
Os campos a seguir na tabela de dados:
-
SalesYear
-
SalesAmount
-
Script de carregamento
Example:
LOAD * INLINE [
SalesYear, SalesAmount
2019, 500
2020, 800
2021, 400
2022, 700
2023, 600
];Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:
-
SalesYear
Crie as seguintes medidas:
-
=Sum(SalesAmount) para agregar as vendas.
-
=RangeSum(Above(SalesAmount, 0, RowNo())) para calcular um total em execução dos valores de SalesAmount.
| SalesYear | Sum(SalesAmount) | RangeSum(Above(SalesAmount, 0, RowNo())) |
|---|---|---|
| Totals | 3000 | 0 |
| 2019 | 500 | 500 |
| 2020 | 800 | 1300 |
| 2021 | 400 | 1700 |
| 2022 | 700 | 2400 |
| 2023 | 600 | 3000 |
Os resultados mostram como você pode usar uma combinação da função RangeSum e da função Above para criar um total acumulado em execução.
Faça o seguinte:
Crie um gráfico de barras e adicione este campo como uma dimensão:
-
SalesYear
Crie a seguinte medida:
-
=RangeSum(Above(SalesAmount, 0, RowNo())) para retornar o valor acumulado de vendas.
Gráfico de barras mostrando o valor acumulado das vendas por ano
