Saltar al contenido principal

Inicio rápido

Esta guía te lleva de un lienzo en blanco a SQL exportado en unos cinco minutos. Construiremos una pequeña parte del ejemplo Acme Storefront que se usa a lo largo de esta documentación.

1. Crear un diagrama​

Haz clic en Nuevo en la esquina superior izquierda. Se abre el asistente Nuevo diagrama con tres formas de empezar:

El asistente Nuevo diagrama

  • Diagrama vacío — un lienzo en blanco (elige este).
  • Importar desde consulta — pega el resultado JSON de una consulta de introspección.
  • Conectar a una base de datos — lee el esquema directamente desde una base de datos activa.

Elige Diagrama vacío, selecciona PostgreSQL como motor, dale un nombre y haz clic en Crear.

2. Añadir una tabla​

Pulsa el botón + Tabla (o haz clic derecho en el lienzo vacío → Añadir tabla). Aparece una nueva tarjeta con una clave primaria id. Haz doble clic en el nombre de la tabla para renombrarla a products, y luego usa + Campo para añadir columnas. Haz clic en el tipo de un campo para abrir el selector de tipos y haz clic en el lápiz para establecer restricciones como not null, unique o default.

Una tarjeta de tabla mostrando las insignias de clave primaria, clave foránea y not-null

Las pequeñas insignias te indican de un vistazo el papel de cada campo: una llave dorada para la clave primaria, un enlace azul para las claves foráneas y NN para las columnas no anulables.

3. Enlazar una clave foránea​

Añade una segunda tabla, categories. Pasa el cursor sobre el campo category_id en products — aparece un pequeño puerto en el borde de la tarjeta. Arrastra desde ese puerto hasta categories.id y suelta. EntityFlow dibuja una arista ortogonal de clave foránea con insignias de cardinalidad (aquí, muchos products a una category). → Relaciones

4. Agrupar y anotar​

Selecciona tablas relacionadas y envuélvelas en un grupo contenedor para mantener legibles los esquemas grandes, y coloca una nota adhesiva para dejar contexto a tus compañeros de equipo.

Dos grupos contenedores, seis tablas y una nota adhesiva

→ Grupos contenedores · Notas adhesivas

5. Exportar SQL​

Haz clic en Exportar en la barra superior. Elige un dialecto — PostgreSQL, MySQL, MariaDB, SQL Server o SQLite — y EntityFlow muestra el DDL en vivo. Cópialo, o cambia a la pestaña Imagen para exportar un PNG/SVG.

El cuadro de diálogo de exportación mostrando el DDL de PostgreSQL en vivo

Ese es todo el ciclo: dibujar → validar → generar. Todo se guarda localmente mientras trabajas (y se sincroniza con el servidor cuando has iniciado sesión).

:::tip Sáltate la escritura ¿No quieres construirlo a mano? Descarga el ejemplo Acme Storefront y cárgalo con Archivo → Importar JSON. :::

A dónde ir después​

  • Conceptos clave — el vocabulario detrás del lienzo.
  • Inicio de sesión — inicio de sesión sin contraseña con tu dirección de correo electrónico y un código de un solo uso.
  • El editor — cada gesto y panel en profundidad.
  • Colaboración — invita a tu equipo al mismo diagrama.