Criar expressões na tabela

Tipo

Como fazer

Para

Engenharia de dados, Analista

Na tela

HorusDW › Tabelas › Editar Tabela › Expressões

Toda Aplicação que usa a tabela enxerga as expressões dela como colunas a mais, calculadas a partir das outras. Use quando a conta vale para qualquer Dashboard (margem, ticket médio, faixa de atraso); conta que só uma Aplicação usa fica melhor como expressão da Aplicação. A linguagem completa está em Linguagem de expressões.

Antes de começar

A tabela precisa estar na sua Minha Mesa: numa tabela publicada, a aba Expressões fica só para leitura. Tabela Datalake não tem expressões, e o Cadastro tem as dele no próprio editor (veja Validações e expressões).

Passos

1. Em HorusDW › Tabelas, clique em Editar na linha da tabela e abra a aba Expressões.
2. Clique em Nova Expressão.
3. Preencha Rótulo (o nome no DataViz), Tipo (Número, Data ou Texto), Máscara e Papel.
4. Escreva a fórmula no editor, em SQL do Apache Doris, citando as colunas pelo nome, sem aspas e sem nome da tabela. O editor sugere as colunas enquanto você digita.
5. Clique em Salvar na tela da tabela.

A expressão pode agregar ou ser calculada linha a linha, e a escolha muda o que ela faz no Dashboard:

A fórmula	Comporta-se como	Exemplo
Usa SUM, COUNT, AVG ou função de janela	Medida: calculada sobre as linhas de cada agrupamento	SUM(VALOR_LIQUIDO) / NULLIF(COUNT(DISTINCT ID_PEDIDO), 0)
Não usa agregação	Dimensão: calculada em cada linha, serve para agrupar e filtrar	CASE WHEN DIAS_ATRASO > 30 THEN 'Vencido' ELSE 'Em dia' END

Proteja toda divisão com NULLIF no denominador, como no exemplo, para que um agrupamento sem pedidos dê vazio em vez de erro.

Gerar com IA

Ao lado do editor, Gerar com IA abre Gerar expressão com IA. Escreva o nome, descreva em O que a expressão deve calcular? (por exemplo, margem bruta: valor menos custo da mercadoria, sobre o valor) e escolha o Comportamento: Medida (agrega) ou Dimensão (agrupa). Clique em Gerar e revise a fórmula antes de salvar. O uso conta nos créditos de IA.

Se der errado

Já existe uma expressão ou coluna com esse rótulo nessa tabela.: outro campo já usa o rótulo. Escolha um nome diferente.

O botão de editar sumiu: a tabela está publicada. Clone para a sua Minha Mesa, ajuste e publique substituindo a original. Veja Publicar uma tabela.

Relacionado

• Configurar uma tabela
• Linguagem de expressões

Pelo Lumo CLI

As expressões da tabela também ficam no YAML, em expressions. Veja a referência de table.