Importar un CSV en DBeaver: ejemplo y comprobaciones

4/5 - (14 votos)

Para importar un CSV con DBeaver, prepara una tabla de destino, abre su opción Import Data y selecciona el archivo. Antes de ejecutar la carga, comprueba el separador, la cabecera y el mapeo de columnas. Practica primero con una tabla vacía de pruebas.

ÍNDICE
  1. Un CSV pequeño para practicar
  2. Configurar la importación
  3. Comprobar el resultado con consultas
  4. Errores frecuentes y cómo aislarlos
  5. Pasar del ejemplo a un archivo real

Un CSV pequeño para practicar

Copia este ejemplo en un archivo llamado productos-prueba.csv, guardado como UTF-8. Utiliza punto y coma como separador y punto para los decimales. Los datos son ficticios.

id;nombre;precio
1;Cuaderno;3.50
2;Lápiz;0.80
3;Carpeta;2.25

Para una base de datos SQLite de pruebas, esta tabla permite ensayar la carga. Si utilizas otro motor, adapta los tipos a ese servidor. El nombre de la tabla ayuda a distinguir este ejercicio de tus datos reales.

CREATE TABLE productos_prueba_csv (
    id INTEGER PRIMARY KEY,
    nombre TEXT NOT NULL,
    precio NUMERIC NOT NULL
);

Configurar la importación

  1. En el navegador de bases de datos, haz clic derecho sobre la tabla y selecciona Import Data.
  2. Elige CSV y selecciona el archivo.
  3. Configura la codificación, el separador y la lectura de la cabecera.
  4. Revisa que cada columna de origen corresponda a la columna correcta de destino.
  5. Comprueba las opciones finales antes de iniciar la transferencia.

Los controles disponibles dependen de la versión. La documentación oficial de importación explica las opciones del asistente.

Comprobar el resultado con consultas

En la tabla recién creada deben aparecer tres filas. La suma de los precios del ejemplo es 6,55. Estas dos comprobaciones detectan una carga incompleta y algunos errores de lectura numérica.

SELECT COUNT(*) AS filas, SUM(precio) AS total_precio
FROM productos_prueba_csv;

SELECT id, nombre, precio
FROM productos_prueba_csv
ORDER BY id;

Comprueba también las palabras con tilde: «Lápiz» debe conservar la á. No basta con que el asistente termine sin error; revisa que las columnas contengan el significado esperado. Una carga de tres filas es suficientemente pequeña para comprobar cada registro.

Errores frecuentes y cómo aislarlos

  • Todo aparece en una sola columna: el separador elegido puede no coincidir con el archivo. Nuestro ejemplo utiliza ;.
  • La cabecera se intenta insertar como una fila: revisa la opción que identifica la primera fila como nombres de columnas.
  • El precio no se interpreta como número: compara el formato decimal del archivo con el tipo de destino. En este ejemplo usamos 3.50, sin símbolo de moneda.
  • Error de clave duplicada: quizá ya importaste el ejemplo. Comprueba los identificadores existentes antes de repetirlo; no borres datos de una tabla real para evitar el mensaje.
  • Columnas cambiadas: revisa el mapeo. Tener tres columnas en ambos lados no garantiza que estén en el mismo orden.

Pasar del ejemplo a un archivo real

Empieza con una muestra y compara el recuento de filas, los importes y algunos registros con el archivo original. Decide cómo tratar valores vacíos y duplicados antes de cargar el conjunto completo. Conserva el CSV original y una copia recuperable de los datos de destino cuando vayas a modificar una tabla existente.

Un CSV no contiene necesariamente relaciones, índices ni toda la estructura de una base de datos. Para guardar datos desde DBeaver, consulta la guía de exportación. Para cambiar de equipo sin copiar registros, consulta cómo exportar e importar conexiones.

Go up