La pantalla de Linaje (/linhagem) responde dos preguntas que todo
equipo de datos se hace tarde o temprano: "¿de dónde vino este número?" y "si cambio
esta tabla, ¿qué se rompe?". El mapa se arma a partir del SQL de cada
visual — no es un dibujo mantenido a mano, es lo que realmente se está ejecutando.
Qué es#
Un mapa vivo del workspace que conecta pipelines → Bronze → Silver → Gold → paneles/informes, más un análisis de impacto inverso y un flujo de certificación (aval) de números oficiales.
Para qué sirve#
- Rastrear el origen de un número antes de confiar en él.
- Prevenir roturas: revisar qué depende de una tabla antes de renombrar una columna o cambiar un pipeline.
- Señalar lo que ya fue revisado, con un sello visible para el lector.
Quién lo hace y cuándo#
- Es área del dueño: la pantalla exige
requireOwnerAreaporque el mapa expone pipelines y tablas de todo el workspace. El miembro invitado es llevado de vuelta al Workspace de BI. - Solo el dueño (owner) avala la certificación;
adminy los demás roles la ven, pero no certifican. - Úsala antes de cualquier cambio estructural de datos y siempre que necesites auditar el origen de un indicador.
Qué muestra la pantalla#
1. Mapa del workspace
Columnas por capa — Pipelines, Bronze, Silver, Gold y tablas externas — con conteo (pipelines · tablas · paneles · informes). Cada tabla muestra de dónde viene y por cuántos paneles/informes es usada. Un sello indica las tablas certificadas.
2. ¿De dónde vino este número? (linaje de un panel)
Elige un panel y ve, lado a lado, los visuales, las tablas que alimentan cada uno (con la capa y si son fuente directa) y los pipelines detrás. Hay un atajo para abrir el panel.
3. Si cambio esta tabla, ¿qué se rompe? (análisis de impacto)
Elige una tabla y ve el efecto inverso: paneles afectados, informes afectados, tablas derivadas y pipelines a revisar. Es lo que evita descubrir el martes que el panel del cliente dejó de funcionar.
4. Certificación (aval)
Marca paneles, informes y conjuntos de datos (tablas) como revisados. El sello aparece en la lista del Workspace y en la parte superior del panel, para que el lector sepa qué número es oficial. Cada certificación registra quién la avaló y cuándo.
Paso a paso (análisis de impacto)#
- Abre
/linhagem. - En la sección "Si cambio esta tabla, ¿qué se rompe?", selecciona la tabla.
- Haz clic en Analizar impacto.
- Revisa los paneles, informes, tablas derivadas y pipelines listados.
- Solo entonces haz el cambio — y, si corresponde, vuelve a certificar lo que cambió.
Resultado esperado#
Un mapa que refleja el SQL en producción, con conteos de uso, y un análisis de impacto que lista todo lo que depende de una tabla antes de que la toques.
Ejemplo#
En Comércio Aurora, el dueño selecciona prd_aurora_silver.vendas en el análisis de
impacto y ve que dos paneles ("Vendas por filial", "Resultado de agosto"), un
informe semanal y la tabla prd_aurora_gold.vendas_por_filial dependen de ella — entonces
avisa al equipo antes de renombrar la columna valor.
Límites y costos#
- Abrir la pantalla: R$ 0 — el grafo se arma a partir de los metadatos (SQL de los visuales), sin consulta paga.
- El mapa cubre lo que tiene SQL rastreable; un panel sin visual con SQL no aparece en el linaje.
Seguridad#
- Todo con alcance por
workspaceId: el grafo de un cliente jamás toca el de otro. - Área restringida al dueño; certificación solo por el owner.
Errores comunes#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| "Todavía no hay nada que mapear" | sin pipeline/panel con SQL | crea un pipeline y un panel que lea del datalake |
| El panel desaparece del linaje | no tiene visual con SQL | agrega un visual que consulte una tabla |
| No puedo certificar | no eres el owner | pídeselo al dueño del workspace |
| Me enviaron al Workspace de BI | la pantalla es área del dueño | accede con una cuenta owner/admin |
Relacionados#
Última revisión: 2026-09-08.