Saltar al contenido principal

CSV a Tabla

Configuración actual de la tarea CSV a Tabla en el Diseñador de Flujos de Trabajo
  • Tipo Tarea: csv-to-table

La Tarea CSV a Tabla está diseñada para importar datos de un archivo en formato CSV (Valores Separados por Coma) e insertarlos en una tabla de una base de datos. Su función es doble: se conecta a una base de datos para escribir físicamente los datos y, al mismo tiempo, expone los datos importados como un Conjunto de Datos para su uso por parte de Tareas posteriores en el Flujo de Trabajo (como un Iterador).

Configuración​

La configuración se divide en dos pestañas principales: Conexión para los detalles de la base de datos y Archivo CSV para las especificaciones del archivo de origen.

1. Pestaña "Conexión"​

Esta sección es idéntica a la de otras Tareas de escritura en bases de datos y define cómo conectarse al destino.

  • Modo de Conexión: Selecciona el origen de las credenciales:
  • Manual: Ingresa manualmente todos los datos de la conexión.
  • Entorno: Selecciona un entorno de conexión preconfigurado para completar automáticamente los campos.
  • Tipo de Base de Datos: Selecciona el tipo de base de datos (ej. PostgreSQL, SQL Server, etc.).
  • Conexión SSL: Especifica si usar una conexión segura (SSL).
  • Autenticación: Ingresa los detalles para el acceso:
  • Host: La dirección del servidor de la base de datos.
  • Puerto: El puerto de comunicación.
  • Nombre de Base de Datos: El nombre de la base de datos.
  • Usuario: El nombre de usuario.
  • Contraseña: La contraseña asociada.

2. Pestaña "Archivo CSV"​

Esta pestaña es el corazón de la Tarea y define cómo el archivo CSV debe ser leído y mapeado.

  • Estructura CSV:
  • Definición de Campo: Al hacer clic en este botón se abre la ventana "Estructura CSV - CSV a Tabla". Aquí se define la estructura de la tabla de destino, mapeando cada columna del CSV. Para cada campo (+ Agregar Campo) se especifican:
  • Nombre: El nombre de la columna en la base de datos.
  • Tipo: El tipo de dato (String, Numérico, etc.).
  • Tamaño: El tamaño del campo.
  • Formato: Un formato específico para datos como las fechas.
  • No Puede Ser Nulo: Si el campo no puede contener valores nulos.
  • Encabezado CSV: Especifica si la primera fila del archivo CSV es un encabezado.
  • Sí: La primera fila contiene los nombres de las columnas y no se importará como dato.
  • No: El archivo no tiene una fila de encabezado; todos los datos se importarán.
  • Codificación: La codificación de caracteres del archivo (ej. UTF-8, ISO-8859-1).
  • Separador: El carácter usado en el archivo CSV para separar los valores (ej. ,, ;, |, =).
  • Caracter de Comillas: El carácter usado para encerrar los campos de texto, especialmente aquellos que contienen el separador (ej. ").
  • Tipo de Importación: El método de importación del archivo.
  • CSV Local: Carga un archivo desde tu computadora a través del botón "Seleccionar archivo".
  • CSV Web: Importa un archivo desde una URL web.
  • CSV Remoto: Importa un archivo desde una ruta de red remota.
  • Tabla de Destino: La acción a realizar sobre la base de datos.
  • Tabla Existente: Inserta los datos en una tabla ya existente.
  • Nueva Tabla: Crea una nueva tabla para los datos importados.
  • Nombre de la Tabla de Destino: El nombre de la tabla de destino. Puede ser un valor estático o dinámico (ej. #>nome_tabella<#).
  • Modo de Carga: Cómo insertar los datos en una Tabla Existente.
  • Agregar: Agrega los nuevos datos a los datos ya presentes.
  • Insertar: Saca completamente la tabla antes de insertar los nuevos datos.

Gestión de la Estructura de la Tabla - Estructura CSV​

En la parte inferior derecha de la ventana Estructura CSV (CSV structure) se encuentran tres botones:

BotónAcción
GuardarGuarda la estructura definida
ImportarImporta una estructura existente
ExportarExporta la estructura definida

Esta funcionalidad permite guardar, exportar o reutilizar las mapeaturas, evitando la compilación manual de los campos y reduciendo el riesgo de errores.

Nota Técnica​

  • Visibilidad: Las estructuras guardadas en el sistema son visibles exclusivamente para el usuario que las creó.
  • Profundización: Para una descripción detallada de todas las opciones y la lógica de funcionamiento, consulte la página Estructura de la tabla.

Parámetros de Salida​

Una vez completada la importación, la Tarea expone los siguientes parámetros:

  • targetTable: Devuelve el nombre de la tabla de la base de datos en la que se insertaron los datos.
  • sourceFilename: Devuelve el nombre del archivo CSV de origen que fue procesado.
  • sourcePath: Devuelve la ruta completa del archivo CSV de origen.
  • count: Indica el número total de filas que fueron importadas del archivo CSV.
  • result: Proporciona el estado general de la ejecución de la Tarea (ej. "Éxito" o un mensaje de error).
  • resultJson: Representa el resultado de la ejecución de la tarea en formato JSON, incluyendo información general, configuraciones y detalles sobre la ejecución.
  • DataExportCsv: Devuelve el conjunto completo de datos procesado, formateado como texto en formato CSV.
  • DataExportJson: Devuelve el conjunto completo de datos procesado, formateado como una cadena JSON.
  • Dataset: Este parámetro representa el nombre de la columna de la tabla (Por ej: name). Es el parámetro más importante para conectar esta Tarea a un Iterador. Para acceder a los valores de una columna específica durante una iteración, se utiliza la sintaxis Dataset.NombreColumna.
  • DataColumn: Este parámetro permite acceder al contenido completo de una columna como una única entidad (por ejemplo, un array o una lista).
  • DataColumn.NombreColumna: Devuelve todos los valores de la columna “NombreColumna”. Por ej: “Luca, Maria, Giovanni, Elena”