12. Diagramas ERD

Visualiza relaciones de clave foránea entre tablas como diagramas entidad-relación generados automáticamente.

12.1 ¿Qué es un ERD?

Un Diagrama Entidad-Relación (ERD) muestra cómo las tablas de base de datos están conectadas a través de restricciones de clave foránea. Responde preguntas como "¿Qué tablas referencian la tabla customers?" o "¿Cómo es la estructura del esquema de orders?" Un ERD es la forma más rápida de incorporar nuevos miembros del equipo a un esquema de base de datos y documentar el modelo de datos para compliance o revisión arquitectónica.

12.2 ERDs en Metaustral

Los diagramas ERD aparecen en la página de detalle de activos tipo TABLE únicamente — como una pestaña ERD dedicada entre Linaje y Glosario. Las relaciones se almacenan en una tabla separada erd_relations, independiente del grafo de linaje, de modo que agregar o eliminar aristas ERD nunca afecta los datos de linaje.

ERD generado automáticamente — diagrama entidad-relación con conexiones de clave foránea entre tablas y etiquetas de relación en cada arista.

12.3 Detección automática de FK

Al importar tablas desde una base de datos conectada, Metaustral detecta automáticamente las restricciones de clave foránea y crea relaciones ERD para ellas. Las relaciones detectadas se marcan con un badge AUTO. La detección es compatible con:

SQL Server — vía sys.foreign_key_columns
MySQL — vía INFORMATION_SCHEMA.KEY_COLUMN_USAGE
PostgreSQL — vía information_schema.table_constraints

DWHs en la nube Snowflake, BigQuery y Databricks no refuerzan restricciones FK a nivel de motor, por lo que la detección automática no está disponible para esos conectores. Puedes agregar relaciones manualmente igualmente.

12.4 Relaciones manuales

Los editores y administradores pueden agregar relaciones manualmente desde la pestaña ERD. Haz clic en + Agregar relación, busca la tabla relacionada, especifica opcionalmente los nombres de las columnas FK y PK, elige un tipo de cardinalidad (muchos a uno, uno a muchos, uno a uno, muchos a muchos) y agrega opcionalmente una etiqueta. Las relaciones agregadas manualmente se marcan con un badge MANUAL y pueden eliminarse en cualquier momento.

Buena práctica Abre la pestaña ERD primero en tus tablas de hechos más importantes (órdenes, transacciones, eventos) — generalmente tienen las más relaciones FK y brindan la vista más clara de tu modelo de datos.