#087 · Herramienta para desarrolladores

CSV Merger

Une varios bloques CSV en un solo archivo manteniendo una única cabecera. Cada documento se separa con una línea ---CSV---; la herramienta valida las columnas y ofrece un modo estricto para exigir la misma cabecera o un modo de unión que crea el conjunto total de columnas y rellena los valores ausentes. El resultado incluye procedencia por bloque y recuentos de filas.

Datos de entrada

Procesamiento local
Espacio publicitario

Cómo usar esta herramienta para desarrolladores

  1. Separa cada CSV con una línea que contenga exactamente ---CSV---.
  2. Selecciona el delimitador y el modo de compatibilidad.
  3. Ejecuta la combinación.
  4. Revisa el número final de columnas y registros antes de descargar el CSV.

Qué hace esta herramienta para desarrolladores

Consolida registros de varias fuentes evitando repetir la cabecera. En modo unión, realinea cada fila por nombre de columna en lugar de asumir que todas las fuentes tienen el mismo orden.

Cada bloque se parsea por separado. El modo estricto compara longitud, nombre y orden de las cabeceras; el modo unión construye una lista única de columnas y remapea cada fila por el nombre de su cabecera original.

Si dos columnas representan el mismo dato con nombres distintos, por ejemplo “email” y “correo”, se tratarán como columnas diferentes; la herramienta no hace equivalencias semánticas.

Ejemplo

CSV A: id,nombre · 2 filas CSV B: id,nombre · 2 filas → salida: 4 registros y una sola cabecera

Casos de uso

  • Combinar exports diarios con el mismo esquema.
  • Unificar lotes antes de una importación.
  • Alinear fuentes con columnas parcialmente distintas.
  • Detectar rápidamente cabeceras incompatibles.

Consejos para obtener resultados fiables

  • Prefiere el modo estricto cuando el esquema debe ser idéntico.
  • Usa unión solo si los nombres de columna son estables y significativos.
  • Normaliza mayúsculas y espacios de las cabeceras antes de unir fuentes heterogéneas.
  • Comprueba el total de filas de entrada frente al resultado.

Detalles del procesamiento

Los bloques se separan por un marcador en una línea independiente. El parser CSV evita romper campos que contengan el delimitador dentro de comillas.

No deduplica registros ni resuelve conflictos de tipos. Tampoco fusiona columnas equivalentes con nombres diferentes.

Preguntas frecuentes

¿Cómo separo los CSV que quiero combinar?

Coloca una línea con ---CSV--- entre cada documento. El marcador debe estar solo en esa línea para que se reconozca como separador.

¿Qué ocurre si los CSV tienen las mismas columnas en distinto orden?

El modo estricto los considera incompatibles. El modo unión remapea los valores por nombre de columna y puede combinar esos esquemas.

¿Se eliminan automáticamente los registros duplicados al combinar?

No. La combinación conserva todos los registros; para deduplicar puedes usar el CSV Deduplicator después.

¿Qué hace el modo unión cuando una columna no existe en un bloque?

Crea la columna en la salida y deja vacío ese campo para las filas procedentes del bloque que no la contiene.

¿Puedo combinar CSV con delimitadores diferentes en cada bloque?

La herramienta aplica un único delimitador a todos los bloques. Conviene normalizar los archivos previamente si utilizan dialectos distintos.

Resumen técnico

ElementoDetalle
Separador de bloques---CSV---
ModosEstricto / unión
Cabecera finalÚnica
DeduplicaciónNo