#04Beginner3 min

Importando SQL

¿Ya tienes una base de datos? Importa tu esquema existente desde archivos SQL o pega sentencias CREATE TABLE para generar un diagrama al instante.

En esta guía

  1. 1Abre el modal de Importar SQL
  2. 2Elige subir un archivo o pegar texto
  3. 3Previsualiza las tablas analizadas
  4. 4Importa y revisa el resultado
  5. 5Gestiona conflictos y advertencias

Paso 1: Abre el modal de Importar SQL

En la barra de herramientas, haz clic en el ícono de Subir (Importar SQL). Esto abre el modal de Importar SQL. Necesitas permisos de editor para importar — los visualizadores verán el botón deshabilitado.

Paso 2: Elige subir un archivo o pegar texto

El modal de importación tiene dos pestañas:

Pestaña Archivo: Arrastra y suelta un archivo .sql en la zona de carga, o haz clic para buscar. ER Flow acepta archivos .sql y .txt. El archivo se lee completamente en el navegador — nada se envía al servidor hasta que hagas clic en Importar.

Pestaña Texto: Pega tu SQL directamente en el área de texto. Útil cuando quieres importar algunas sentencias CREATE TABLE de tu código fuente o una exportación de base de datos.

El parser de ER Flow soporta SQL estándar de PostgreSQL, MySQL y SQLite, incluyendo:

  • CREATE TABLE con todos los tipos de columna y restricciones
  • PRIMARY KEY, UNIQUE, NOT NULL, DEFAULT en línea
  • FOREIGN KEY ... REFERENCES con reglas de cascada ON DELETE / ON UPDATE
  • CREATE INDEX y CREATE UNIQUE INDEX (independientes)
  • Nombres de tabla con schema (por ejemplo, public.users)
  • Identificadores entre comillas (comillas dobles, backticks, corchetes)

Paso 3: Previsualiza las tablas analizadas

En cuanto pegas o subes el SQL, el parser se ejecuta inmediatamente y muestra un panel de previsualización en la parte inferior del modal. Verás:

  • Cuántas tablas se encontraron
  • El nombre de cada tabla y cuántas columnas tiene
  • Cualquier error de análisis (resaltado en rojo)

Esta previsualización te permite verificar que el SQL se analizó correctamente antes de importar.

Paso 4: Importa y revisa el resultado

Haz clic en "Importar" para aplicar el esquema analizado. ER Flow:

  1. Creará nuevas tablas para cualquier tabla que no esté en tu esquema
  2. Reutilizará tablas existentes si ya existe una tabla con el mismo nombre (agrega columnas faltantes, omite las existentes)
  3. Creará claves foráneas entre tablas, resolviendo las referencias automáticamente
  4. Creará índices (tanto sentencias CREATE INDEX en línea como independientes)
  5. Creará tablas stub para tablas referenciadas que no estaban incluidas en el SQL (por ejemplo, si una FK referencia una tabla que no está en la importación)

Todas las tablas importadas aparecen en el canvas en la misma posición — tendrás que organizarlas después de la importación.

Paso 5: Gestiona conflictos y advertencias

Después de la importación, puedes ver un toast de éxito con advertencias:

  • "La tabla X ya existe. Importada como X_2" — el nombre de la tabla ya estaba tomado, por lo que fue renombrada
  • "La columna X.y ya existe con un tipo diferente. Se mantuvo el tipo actual." — la columna existe pero con un tipo diferente; el tipo existente se conserva
  • "La tabla referenciada X no está en el SQL. Se creó stub." — una FK referencia una tabla que no está en la importación; se creó una tabla de marcador de posición
  • "La tabla X tenía una PK de tipo entero llamada id sin auto-incremento. Marcada como auto-incremento." — patrón común detectado y corregido automáticamente

Todos los cambios importados pueden deshacerse con Ctrl+Z si algo no se ve bien.