Linhagem

Selo de estado: GA-candidato (grafo de linhagem, análise de impacto, certificação — determinísticos e testados) · Atualizado em 2026-09-08. Fonte de estado: matriz de estados do produto (Governança: classificação herdada, impacto, freshness e certificação). Limite atual do produto = Preview.

A tela de Linhagem (/linhagem) responde duas perguntas que todo time de dados faz cedo ou tarde: "de onde veio este número?" e "se eu mexer nesta tabela, o que quebra?". O mapa é montado a partir do SQL de cada visual — não é um desenho mantido à mão, é o que está rodando de verdade.

O que é#

Um mapa vivo do workspace ligando pipelines → Bronze → Silver → Gold → painéis/relatórios, mais uma análise de impacto reversa e um fluxo de certificação (endosso) de números oficiais.

Para que serve#

• Rastrear a origem de um número antes de confiar nele.
• Prevenir quebras: conferir o que depende de uma tabela antes de renomear uma coluna ou trocar um pipeline.
• Sinalizar o que já foi revisado, com um selo visível para o leitor.

Quem faz e quando#

• É área do dono: a tela exige requireOwnerArea porque o mapa expõe pipelines e tabelas de todo o workspace. Membro convidado é levado de volta ao Workspace de BI.
• Só o dono (owner) endossa a certificação; admin e demais papéis veem, mas não certificam.
• Use antes de qualquer mudança estrutural de dados e sempre que precisar auditar a origem de um indicador.

O que a tela mostra#

1. Mapa do workspace

Colunas por camada — Pipelines, Bronze, Silver, Gold e tabelas externas — com contagem (pipelines · tabelas · painéis · relatórios). Cada tabela mostra de onde vem e por quantos painéis/relatórios é usada. Um selo indica tabelas certificadas.

2. De onde veio este número? (linhagem de um painel)

Escolha um painel e veja, lado a lado, os visuais, as tabelas que alimentam cada um (com a camada e se são fonte direta) e os pipelines por trás. Há atalho para abrir o painel.

3. Se eu mexer nesta tabela, o que quebra? (análise de impacto)

Escolha uma tabela e veja o efeito reverso: painéis afetados, relatórios afetados, tabelas derivadas e pipelines a revisar. É o que evita descobrir na terça que o painel do cliente parou.

4. Certificação (endosso)

Marque painéis, relatórios e conjuntos de dados (tabelas) como revisados. O selo aparece na lista do Workspace e no topo do painel, para o leitor saber qual número é oficial. Cada certificação registra quem endossou e quando.

Passo a passo (análise de impacto)#

1. Abra /linhagem.
2. Na seção "Se eu mexer nesta tabela, o que quebra?", selecione a tabela.
3. Clique em Analisar impacto.
4. Revise painéis, relatórios, tabelas derivadas e pipelines listados.
5. Só então faça a mudança — e, se for o caso, re-certifique o que mudou.

Resultado esperado#

Um mapa que reflete o SQL em produção, com contagens de uso, e uma análise de impacto que lista tudo o que depende de uma tabela antes de você mexer.

Exemplo#

Na Comércio Aurora, o dono seleciona aurora_silver.vendas na análise de impacto e vê que dois painéis ("Vendas por filial", "Resultado de agosto"), um relatório semanal e a tabela aurora_gold.vendas_por_filial dependem dela — então avisa o time antes de renomear a coluna valor.

Limites e custos#

• Abrir a tela: R$ 0 — o grafo é montado dos metadados (SQL dos visuais), sem consulta paga.
• O mapa cobre o que tem SQL rastreável; um painel sem visual com SQL não aparece na linhagem.
• Freshness/escala em produção não medidos hoje (teto Preview).

Segurança#

• Tudo escopado por workspaceId: o grafo de um cliente jamais toca o de outro.
• Área restrita ao dono; certificação só pelo owner.

Erros comuns#

Relacionados#

• Segurança por linha (RLS/ABAC)
• Organização e workspaces
• Auditoria

Última revisão: 2026-09-08. Estado & evidência: Governança: classificação herdada, impacto, freshness e certificação = GA-candidato. Fonte: matriz de estados do produto.