O que são medidas calculadas?

Este artigo explica as medidas calculadas e como elas podem ser usadas para executar cálculos sem modificar consultas de conjunto de dados.

Visão geral

Nos painéis de IA/BI, as visualizações são baseadas em conjuntos de dados definidos na guia Data. As medidas calculadas fornecem uma maneira de criar e visualizar novos campos de dados sem alterar o conjunto de dados original. Por exemplo, em um conjunto de dados de vendas que inclui dados de item, região, preço e custo, convém calcular e visualizar a margem de lucro para cada região.

A tabela a seguir mostra um exemplo de conjunto de dados inicial:

Número	Região	Preço	Custo
Maçãs	EUA	30	15
Maçãs	Canadá	20	10
Laranjas	EUA	20	15
Laranjas	Canadá	15	10

Sem medidas calculadas, adicionar uma margem de lucro exigiria a criação de um novo conjunto de dados com uma coluna de margem adicional. A tabela a seguir mostra o conjunto de dados resultante:

Região	Margem
EUA	0.40
Canadá	0.43

Embora essa abordagem funcione, o novo conjunto de dados é estático e pode oferecer suporte apenas a uma única visualização. Os filtros aplicados ao conjunto de dados original não afetam o novo conjunto de dados sem ajustes manuais adicionais. Usando uma medida calculada, em vez disso, você pode manter o conjunto de dados original e definir uma fórmula para calcular a margem de lucro dinamicamente.

A fórmula de exemplo a seguir calcula a margem de lucro com base em valores agregados de preço e custo:

(SUM(Price) - SUM(Cost)) / SUM(Price)

A medida calculada resultante pode ser usada em visualizações de painel. Se um filtro for aplicado ao conjunto de dados usando um widget na tela, os gráficos que usam a medida calculada serão atualizados automaticamente para refletir os dados filtrados.

Criar uma medida calculada

Este exemplo cria uma medida calculada com base no conjunto de dados samples.nyctaxi.trips. Pressupõe conhecimentos gerais sobre como trabalhar com dashboards de IA/BI. Se você não estiver familiarizado com a criação de painéis de IA/BI, consulte Criar um painel para começar.

1. Na guia Data, crie um conjunto de dados usando a seguinte instrução:

SELECT * FROM samples.nyctaxi.trips

1. Renomeie o conjunto de dados Dados do táxi.
2. Clique Medida Calculada. Um painel Criar Medida Calculada abre-se no lado direito do ecrã.
3. No campo de texto Nome, insira Custo por milha.
4. (Opcional) No campo de texto Descrição, digite "Usa o valor da tarifa e a distância da viagem para calcular o custo por milha".
5. No campo Expressão, insira SUM(fare_amount) / SUM(trip_distance).
6. Clique Criar.

A nova medida calculada aparece na secção de Medidas da aba de Esquema no painel de resultados. O ícone fx indicam uma medida calculada.

Usar uma medida calculada em uma visualização

Você pode usar a medida Custo por milha criada anteriormente em uma visualização.

1. Clique em Canvas. Em seguida, coloque um novo widget de visualização na tela.
2. Use o painel de configuração de visualização para editar as configurações da seguinte maneira:
   • Conjunto de dados: dados do táxi
   • Visualização: Bar
   • eixo X:
     • Domínio: dropoff_zip
     • Tipo de escala: Categórica
     • Transform: Nenhum
   • eixo Y:
     • Custo por milha

A imagem a seguir mostra o gráfico.

As visualizações que incluem medidas calculadas são atualizadas dinamicamente com base nos filtros aplicados. Por exemplo, se você adicionar um filtro para pickup_zip à tela e selecionar um valor de filtro, a visualização será atualizada para exibir a métrica de custo por milha somente para viagens originadas do valor de filtro selecionado. O gráfico de barras resultante reflete os dados filtrados de acordo.

Editar uma medida calculada

Para editar uma medida:

1. Clique no separador Data e, em seguida, clique no conjunto de dados associado à medida que pretende editar.
2. Clique na guia Esquema no painel de resultados.
3. A secção Medidas aparece por baixo da lista de campos. Clique no menu menu kebab à direita da medida que você deseja editar. Em seguida, clique em Editar.
4. No painel Editar medida calculada, atualize os campos de texto que pretende editar. Em seguida, clique em Atualizar.

Excluir uma medida calculada

Para eliminar uma medida:

1. Clique no separador Data e, em seguida, clique no conjunto de dados associado à medida que pretende editar.
2. Clique na guia Esquema no painel de resultados.
3. A secção Medidas aparece por baixo da lista de campos. Clique no menu menu kebab à direita da medida que você deseja editar. Em seguida, clique em Excluir.
4. Clique em Eliminar na caixa de diálogo Eliminar que aparece.

Limitações

Para usar medidas calculadas, o seguinte deve ser verdadeiro:

• O resultado da expressão SQL deve ser agregado.
• As colunas usadas na expressão devem pertencer ao mesmo conjunto de dados.
• A expressão não pode incluir chamadas para tabelas ou fontes de dados externas.

Funções suportadas

As tabelas a seguir listam as funções suportadas. A tentativa de usar uma função sem suporte resulta em um erro.

Funções agregadas

Todas as medidas calculadas devem ser agregadas. As seguintes operações de agregação são suportadas:

Agregação	Descrição
média (expr) ou média (expr)	Devolve a média calculada numa coluna ou expressão
contagem(*)	Devolve o número de linhas num conjunto de dados
contagem((DISTINTO) *)	Devolve o número de linhas únicas
soma(expr)	Devolve o total de valores numa coluna ou expressão
max(expr)	Devolve o valor máximo numa coluna ou expressão
min(expr)	Devolve o valor mínimo numa coluna ou expressão
percentil (expr, percentagem [,frequência])	Devolve o valor de percentil exato de expr na percentagem especificada num grupo.
primeiro(expr[,ignoreNull])	Devolve o primeiro valor de expr para um grupo
last(expr[,ignoreNull])	Devolve o último valor de expr para o grupo

Operações aritméticas

Você pode combinar expressões com as seguintes operações aritméticas:

Expressão	Descrição
expr1 + expr2	Devolve a soma de expr1 e expr2
EXPR1 - EXPR2	Devolve a diferença ao subtrair expr2 de expr1
multiplicador * multiplicando	Devolve o produto de duas expressões
dividendo/divisor	Devolve o resultado da divisão do dividendo pelo divisor
- expr	Devolve o valor negado da expressão
+ expr	Devolve o valor da expressão
try_add(expr1, expr2)	Adiciona dois valores, retorna NULL se qualquer um dos valores for NULL
try_subtract(expr1, expr2))	Subtrai expr2 de expr1, retorna NULL se qualquer um dos valores for NULL
try_multiply(multiplicador, multiplicando))	Multiplica dois números, retorna NULL se qualquer um dos valores for NULL
try_divide(dividendo, divisor)	Divide o dividendo pelo divisor, retorna NULL se qualquer um dos valores for NULL