Contexto de linha × contexto de filtro

Selo de estado: Preview (teto atual do produto) · Curso ACD-320 — Fórmulas pt-BR: de SOMA a CALCULAR · Aula 5 de 13 · Atualizado em 2026-10-04.

Objetivo#

Ao final desta aula você vai prever o valor em cada célula do visual.

Vídeo#

Identificador no manifesto: acd-320-05-contexto-de-linha-e-filtro · duração-alvo 8 min · tela do produto: /dashboards.

Roteiro:

Conteúdo#

Se existe UM conceito que separa "planilha" de "modelo analítico", é este. Até aqui você escreveu fórmulas isoladas; a partir de agora, a mesma fórmula muda de resultado de célula para célula do mesmo visual — e entender por quê é o que faz uma medida dar o número certo em qualquer lugar onde ela aparecer.

As duas perguntas que toda medida responde

Quando o motor calcula uma medida, ele responde duas coisas:

1. Sobre quais linhas? — é o contexto de filtro.
2. Uma linha por vez, ou o conjunto de uma vez? — é o que separa contexto de linha de agregação.

Contexto de filtro: o conjunto visível agora

É o conjunto de linhas que está visível no momento do cálculo — definido pelo eixo/legenda do visual, pelos filtros e slicers, pelo drill. A mesma medida dá números diferentes em cada célula porque cada célula tem um contexto de filtro diferente, não porque a fórmula mudou.

SOMA(valor)

Numa matriz por categoria × mês, cada célula soma só as vendas daquela categoria naquele mês. A fórmula é uma só; o contexto é que recorta.

CALCULAR(SOMA(valor); FILTRAR(categoria = "Bebidas"))

Isso força o recorte para "Bebidas" independentemente do que estiver selecionado naquela dimensão — é a exceção (modificar o contexto de propósito), não a regra. A aula 6 aprofunda CALCULAR e seus modificadores.

Regra de ouro: você quase nunca "passa" o filtro para a medida. O visual e os slicers já criam o contexto; a medida só soma o que está visível.

Contexto de linha: uma linha de cada vez

Existe quando a fórmula é avaliada linha a linha — é o caso de uma coluna calculada.

valor - custo

Para cada linha de vendas, o motor conhece o valor e o custo daquela linha e faz a subtração. Não há soma aqui — é puramente linha a linha, e o resultado vira uma coluna nova que qualquer agregação (SOMA, MEDIA...) pode somar depois.

Por que uma coluna solta trava numa medida agregada

Uma coluna nua (valor, sem SOMA em volta) só faz sentido em contexto de linha. Se você a usa direto numa medida agregada, sem dizer como agregar, o editor recusa — porque "o valor" de um conjunto de várias linhas é ambíguo:

valor

Erro: Coluna solta em medida agregada: valor — use SOMA(valor). A trava existe para pegar exatamente esse esquecimento — mas ela olha a presença de uma linha corrente, não só o modo. Dentro de um iterador (aula 7) ou de um FILTRAR, existe uma linha corrente, e aí a coluna nua é justamente o que se quer.

As duas colunas, lado a lado

A transição de contexto, em uma frase

Quando uma medida é usada dentro de um iterador (que roda em contexto de linha), a linha atual vira um filtro e a medida é reavaliada como se aquela linha fosse o recorte — é a transição de contexto. A aula 7 (SOMAX, MEDIAX...) é construída inteira sobre essa ideia; por ora, memorize o nome: você vai precisar dele para entender por que SOMAX(qtd * preco) soma linha a linha em vez de multiplicar dois totais.

Erros comuns

• Somar uma coluna calculada de linha achando que ela já é a medida total — envolva numa agregação (SOMA(...)) para o total.
• Esperar que um slicer "entre" na medida sozinho quando a fórmula usa TUDO() (aula 6) — se a medida remove o filtro, o slicer daquela dimensão deixa de recortá-la. É o comportamento pedido, mas surpreende quem não sabia.
• Confundir contexto de filtro com "os dados que eu carreguei" — é sobre o que está visível na tela agora, não sobre a tabela inteira.

Estado da capacidade

A semântica composta de contexto (C06.2) está em Preview, com resultado idêntico a cada execução — fixada por suíte de testes de referência.

Faça você mesmo#

No workspace de treino Aurora Varejo (abra /dashboards no console):

1. Monte uma matriz com categoria nas linhas e mês nas colunas, com a medida SOMA(valor).
2. Antes de olhar o número de 2 categorias × 3 meses (6 células), escreva no papel a previsão de cada uma, só olhando os dados brutos.
3. Compare com o que o visual mostra e confira se bateu.
4. Crie uma coluna calculada valor - custo e confirme que ela aparece linha a linha na tabela de detalhe (não como um total).

Você terminou quando suas 6 previsões baterem com o visual e você conseguir apontar, para cada célula, qual era o contexto de filtro que produziu aquele número.

Checagem rápida#

Três perguntas no final da aula, corrigidas no servidor. A aula só conta como concluída depois da checagem.

Documentação relacionada#

• bi/contexto-linha-e-filtro
• formulas/calcular

Capacidades ensinadas#

C06.2 — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".