Expressões e funções

Os três sítios onde se escreve alguma coisa que não é texto livre: fórmulas de medidas calculadas, condições de consulta e SQL avançado.

Fórmulas de medidas calculadas

Uma medida calculada tem operandos (escolhidos em seletores) e uma fórmula (escrita).

O que a fórmula aceita

Elemento	Exemplo
Nomes de operandos declarados	Receita
Números	100, 0.5
Operadores	+, -, *, /
Parênteses	(A - B) / B
Sinal negativo	-A

Mais nada: não há funções, texto, comparações nem condicionais.

Regras de escrita

• os nomes de operandos começam por letra e usam letras, dígitos e _;
• os decimais escrevem-se com ponto: 0.5, não 0,5;
• as percentagens fazem-se com * 100, não com %;
• a multiplicação e a divisão têm precedência sobre a soma e a subtracção.

Divisão

Toda a divisão sai protegida contra denominador zero: o resultado é vazio em vez de erro.

O numerador é convertido para decimal antes de dividir, para que duas colunas de inteiros não produzam um resultado truncado.

Mensagens de erro

Mensagem	Causa
A fórmula acaba a meio — falta um valor.	Um operador sem nada a seguir
Falta fechar um parêntesis.	Parênteses desequilibrados
Há texto a mais no fim da fórmula.	Sobra alguma coisa depois da expressão
O carácter "x" não é permitido numa fórmula.	Um símbolo fora do conjunto permitido
"x" não é um número.	Um literal numérico inválido

Ver Medidas calculadas.

Operadores de condição

Usados nas condições de consulta e nos filtros do dashboard.

Operador	Significado	Tipos
eq	Igual	Todos
neq	Diferente	Todos
contains	Contém o texto	Texto
startsWith	Começa por	Texto
endsWith	Termina em	Texto
gt	Maior que	Números e datas
gte	Maior ou igual	Números e datas
lt	Menor que	Números e datas
lte	Menor ou igual	Números e datas

Num campo numérico, comparações que não sejam de texto comparam como número.

Uma condição cujo valor esteja vazio não é aplicada.

Variação face ao período anterior

Uma coluna de saída pode valer a diferença entre o seu período e o anterior da mesma série.

Escolha	O que é
Campo e agregado	O que se compara (SUM(valor))
Coluna de ordenação	O nome de saída que ordena a série, normalmente a data
Forma	Percentagem ou diferença absoluta

A comparação corre depois do agrupamento, o primeiro período fica vazio (não zero), e a divisão é feita em decimal. Uma coluna de variação é sempre uma medida.

Ver Dimensões e medidas.

Só o período mais recente

Uma condição sobre um campo de data pode valer "a data mais alta que existe nesta tabela", em vez de operador e valor.

O valor sai dos dados, não do relógio, e a procura ignora as outras condições da consulta — o mais recente é o dos dados, não o do que sobra depois de filtrar.

Ver Filtros da consulta.

Períodos relativos

Nos filtros de data, em vez de operador e valor, escolhe-se uma janela relativa a hoje:

Unidade	Exemplo
Dia	últimos 30 dias
Mês	últimos 12 meses
Ano	últimos 2 anos

A data é calculada no servidor, no momento da consulta, e só se aplica a campos cujo tipo seja mesmo data.

Agregados

Função	O que faz
SUM	Soma
AVG	Média das linhas
MIN	Menor valor
MAX	Maior valor
COUNT	Número de linhas
COUNT_DISTINCT	Número de valores diferentes

Granularidade temporal

Granularidade	Valor produzido
Dia	2026-03-25
Semana	2026-W12
Mês	2026-03
Trimestre	2026-Q1
Ano	2026

Ordenam correctamente por ordem alfabética, e é por isso que têm esta forma.

Modo SQL

O construtor tem um modo avançado onde se escreve o SELECT à mão.

Regras:

• apenas um statement, sem ;;
• tem de começar por SELECT ou WITH;
• qualquer palavra de escrita ou de definição de estrutura é recusada: insert, update, delete, drop, alter, create, truncate, replace, attach, pragma, vacuum, grant, revoke.

Diferenças importantes:

• escrevem-se os nomes reais das tabelas, não os nomes das entidades;
• a consulta não é analisada pelo construtor, portanto os filtros do dashboard podem não a alcançar;
• uma tabela reimportada pode mudar de nome.

Reserve o modo SQL para o que o construtor visual não faz: subconsultas, funções de janela, uniões.

Máscaras

Nas colunas de tabela, tanto de texto como de número, existe um modo de máscara: um padrão em que # representa um carácter ou dígito.

Máscara	Valor	Resultado
####-###	4900123	4900-123
### ### ###	912345678	912 345 678

Uma máscara vazia deixa o valor tal e qual. Ver Formatos de valor.