SQL a diagrama ER

Cómo funciona

1. 01

   Pega o suelta tu SQL

   Sentencias CREATE TABLE, un archivo de migración o un volcado completo de pg_dump, mysqldump, SSMS o sqlite3. Puedes soltar varios archivos .sql a la vez y se leen juntos, hasta 8 MB en total.

2. 02

   Mira el diagrama ER

   Cada tabla se convierte en una tarjeta que lista sus columnas con su tipo y las marcas PK, FK y UK. Cada clave foránea se convierte en una línea desde la columna que la contiene hasta la clave a la que apunta.

3. 03

   Ábrelo en Archboard

   Guárdalo como un diagrama nuevo para reorganizarlo, anotarlo, compartir un enlace o exportarlo en SVG y PNG. Para registrarte basta una cuenta de Google o GitHub.

Qué se dibuja a partir de tu SQL

El diagrama se construye con estas partes de las sentencias CREATE TABLE:

• CREATE TABLE

  Cada CREATE TABLE como una tarjeta con el nombre de la tabla y una fila por columna: su nombre, su tipo y un signo de interrogación si admite NULL. Las tarjetas muestran hasta 24 columnas y luego cuántas quedan.

• PRIMARY KEYUNIQUE

  Las claves primarias, marcadas como PK en cada columna que abarcan, aunque abarquen varias. Una restricción UNIQUE, o un índice único creado con CREATE UNIQUE INDEX, sobre una sola columna marca esa columna como UK.

• FOREIGN KEYREFERENCESALTER TABLE

  Las claves foráneas escritas en línea con REFERENCES, declaradas como restricciones de tabla o añadidas después con ALTER TABLE, cada una dibujada como una línea entre las dos columnas. También se muestra una clave que apunta a su propia tabla, como parent_id.

• CREATE SCHEMA

  Los esquemas, creados con CREATE SCHEMA o usados en nombres como sales.orders, dibujados como marcos alrededor de sus tablas cuando el SQL usa más de uno. Un esquema sin tablas no tiene marco.

• NOT NULLUNIQUE

  Extremos de pata de gallo que leen la relación a partir de las columnas: una clave foránea NOT NULL es obligatoria, una que admite NULL es opcional, y si la clave foránea además es única o es la clave primaria, la relación es uno a uno.

Dialectos SQL que lee

PostgreSQL, MySQL y MariaDB, SQL Server y SQLite se leen cada uno con sus propias reglas de comillas, comentarios y separadores de sentencias, así que un archivo de pg_dump, un mysqldump con bloques DELIMITER o un script de SSMS lleno de líneas GO funcionan tal cual. Oracle se lee en parte: se dibujan las tablas, las claves y las claves foráneas, y se omiten los bloques PL/SQL que terminan con una línea que solo contiene una barra. Si las pistas se contradicen, entra un lector genérico, y puedes elegir el dialecto tú mismo en cualquier momento.

Lo que el diagrama ER deja fuera

• Las filas de datos. INSERT, COPY y otras sentencias de datos se omiten sin leerse, así que un volcado con datos da el mismo diagrama que uno solo del esquema.
• Vistas, funciones, procedimientos, disparadores y secuencias. Se omiten, y la vista previa indica cuántos de cada tipo quedaron fuera. Las vistas y los disparadores que mysqldump escribe dentro de comentarios de versión se omiten como comentarios y no se cuentan.
• Valores por defecto, expresiones CHECK, comentarios y los valores permitidos de las columnas ENUM y SET. Las columnas muestran solo su nombre, su tipo y sus marcas de clave.
• Todo lo que viene de un servidor en marcha. La herramienta lee el texto SQL que le das y no se conecta a ninguna base de datos, así que no se muestran recuentos de filas, tamaños de tabla ni planes de consulta.