Pular para o conteúdo
ingestia.ioingestia.io
Ingestia AcademyProgresso
ACD-310 — Modelo semântico e modelagem dimensionalPreview

Pastas, certificação, grafo de dependência

Aula 8 de 107 minOperarAtualizada em 2026-10-04

Vídeo em produção

A gravação desta aula está no lote de produção. O objetivo, o exercício e a documentação já valem. Duração-alvo: 7 min.

Objetivo: Organizar medidas; ler impacto

Selo de estado: Preview (teto atual do produto) · Curso ACD-310 — Modelo semântico e modelagem dimensional · Aula 8 de 10 · Atualizado em 2026-10-04.

Objetivo#

Ao final desta aula você vai criar medidas centrais reutilizáveis, organizá-las em pastas e ler o relatório de impacto antes de editar uma medida usada por outros visuais.

Vídeo#

Identificador no manifesto: acd-310-08-biblioteca-de-medidas-centrais · duração-alvo 7 min · tela do produto: /dashboards.

Roteiro:

  1. 00:00–01:00 — O problema: "ticket médio" digitado em 10 widgets, divergindo em silêncio · tela: /dashboards/[id] (dois cartões com fórmulas parecidas, mas diferentes)
  2. 01:00–02:30 — Criando Receita, Pedidos e Ticket médio na biblioteca de medidas · tela: /dashboards/[id] (editor de medida central)
  3. 02:30–03:30 — Reutilizando por referência: MEDIDA('Receita') em outra medida · tela: /dashboards/[id] (fórmula de Ticket médio)
  4. 03:30–05:00 — Pastas, descrição, selo certified e hidden · tela: /dashboards/[id] (biblioteca de medidas, árvore de pastas)
  5. 05:00–06:30 — Relatório de impacto: quem usa Receita antes de editar a fórmula · tela: /dashboards/[id] (painel "Impacto")
  6. 06:30–07:00 — Grafo de dependência e detecção de ciclo · tela: /dashboards/[id] (grafo visual de dependências)

Conteúdo#

As aulas anteriores deram ao modelo as ligações certas. Esta aula dá ao modelo as medidas — os números reutilizáveis que todo visual vai consumir — e as ferramentas para organizá-las sem perder o controle quando o workspace cresce. A referência completa é Medidas, fórmulas e KPIs.

O problema que a biblioteca resolve

Sem uma biblioteca central, cada widget que precisa de "ticket médio" reescreve a própria fórmula. Com dez widgets, é questão de tempo até duas dessas cópias divergirem silenciosamente — uma exclui cancelamentos, outra não, e ninguém percebe até o número bater errado numa reunião. A biblioteca de medidas centrais resolve isso declarando a medida uma vez no modelo e deixando que outras medidas e widgets a referenciem.

Criando as três medidas centrais da Aurora

As três medidas centrais mais usadas em qualquer dashboard de vendas são, na notação do catálogo de fórmulas:

formula
SOMA(valor)
formula
CONTD(pedido_id)
formula
DIVIDIR(SOMA(valor); CONTD(pedido_id))

No editor, você as nomeia Receita (SOMA(valor)), Pedidos (CONTD(pedido_id) — conta pedidos distintos, não linhas de item) e Ticket médio (a divisão das duas, que entrega vazio em vez de erro quando não há pedidos no período, graças ao DIVIDIR).

Reutilizando por referência, não por cópia

O ganho real da biblioteca aparece quando uma medida nova precisa de outra já existente. Em vez de repetir a fórmula, você cita a medida central pelo nome com MEDIDA('nome') — por exemplo, uma medida de "Margem %" poderia ser escrita como DIVIDIR(MEDIDA('Margem'); MEDIDA('Receita')). Se a definição de Receita mudar um dia (por exemplo, para excluir uma categoria de devolução), toda medida que a cita por MEDIDA('Receita') muda junto, sem precisar editar nada manualmente — é a diferença entre reaproveitar uma definição e copiá-la.

Nota

MEDIDA() sem nenhum nome dentro só é válido dentro de um grupo de cálculo (fora do escopo desta aula). Numa medida central, é obrigatório citar outra pelo nome: MEDIDA('Receita').

Pastas, certificação e visibilidade

Com mais de três medidas, a biblioteca ganha organização:

  • Pastas agrupam medidas por assunto ("Comercial", "Financeiro") para facilitar a busca no editor de visual.
  • Descrição (até ~300 caracteres) documenta o que a medida faz, sem precisar abrir a fórmula — essa mesma descrição é o que a IA usa para explicar a medida no Q&A, sem inventar nada (ver aula 1 e Como a IA entende seus dados).
  • O selo certified sinaliza "esta é a versão oficial" para quem está escolhendo entre medidas parecidas.
  • hidden esconde uma medida auxiliar (usada só como peça de outras fórmulas) da lista que aparece para quem monta visuais.

Relatório de impacto: olhe antes de editar

Antes de mudar a fórmula de uma medida usada em vários lugares, o relatório de impacto mostra exatamente quem a usa: quais outras medidas a referenciam e em quais widgets ela aparece. Editar Receita sem consultar o impacto é como trocar a fundação de uma casa sem saber quantos cômodos estão em cima dela.

Grafo de dependência e detecção de ciclo

Toda vez que uma medida cita outra, essa referência entra num grafo de dependência. O editor usa esse grafo para dois fins: montar o relatório de impacto (de baixo para cima: "quem depende de mim?") e detectar ciclos (Margem citando Ticket médio que cita Margem de volta) — um ciclo é recusado com o caminho completo mostrado, não só um erro genérico.

Como isso aparece no produto

Tudo isso vive no editor do dashboard (/dashboards/[id]), na biblioteca de medidas: criar/editar com autocomplete e validação ao vivo, pastas na árvore lateral, selo de certificação ao lado do nome, e o botão de impacto antes de salvar uma edição.

Erros comuns

  • Copiar a fórmula em vez de referenciar. Reescrever SOMA(valor) em cada medida nova em vez de citar MEDIDA('Receita') é exatamente o padrão que a biblioteca existe para evitar.
  • Editar uma medida certificada sem olhar o impacto. Uma mudança "pequena" pode afetar dez widgets que você nem lembrava que existiam.
  • Criar um ciclo sem perceber. Isso só acontece quando as medidas já estão emaranhadas; o editor recusa e mostra o caminho — use essa mensagem para desfazer a dependência circular, não para forçar a fórmula de outro jeito.

Faça você mesmo#

No workspace de treino Aurora Varejo (abra /dashboards no console, editor de um painel, biblioteca de medidas):

  1. Crie a medida central Receita com a fórmula SOMA(valor).
  2. Crie a medida central Pedidos com a fórmula CONTD(pedido_id).
  3. Crie a medida central Ticket médio referenciando as duas anteriores: DIVIDIR(MEDIDA('Receita'); MEDIDA('Pedidos')).
  4. Use as três num cartão de KPI cada, em páginas diferentes do mesmo painel.
  5. Organize-as numa pasta chamada "Comercial" e marque Receita como certified.
  6. Abra o relatório de impacto de Receita e confirme que ele lista Ticket médio e os cartões de KPI que você criou.
  7. Edite a fórmula de Receita (por exemplo, trocando temporariamente a coluna somada) só para observar Ticket médio mudar junto — depois desfaça a edição.

Você terminou quando conseguir editar Receita uma única vez e ver Ticket médio e todos os cartões de KPI atualizarem juntos, sem editar cada um manualmente.

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#

Capacidades ensinadas#

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

Carregando seu progresso…