Combine dos CSV por clave y detecte filas sin coincidencia

Pegue ambos textos CSV, indique el encabezado común y obtenga una unión izquierda predecible sin configurar una base de datos ni escribir un script temporal. La respuesta también separa los registros sin correspondencia de ambos lados para facilitar su revisión. Los valores entrecomillados, las claves repetidas, las colisiones de encabezados y los finales de línea habituales se procesan de forma determinista.

Prepare dos archivos CSV con una clave compartida fiable

Identifique primero la columna que representa el mismo elemento en ambos archivos, como customer_id, order_number, sku o email. El encabezado debe coincidir exactamente con el valor de clave que envíe, incluidas las mayúsculas y los espacios. Los demás encabezados pueden ser distintos. El CSV izquierdo es la tabla principal: todos sus registros permanecen en el resultado combinado, exista o no una coincidencia a la derecha. El CSV derecho aporta columnas adicionales cuando coincide su clave. Utilice un identificador estable siempre que sea posible. Los nombres y las descripciones suelen cambiar, contener espacios incoherentes o repetirse, mientras que un identificador del sistema resulta más seguro. El analizador admite campos entrecomillados, comillas dobles escapadas, comas dentro de valores entrecomillados, saltos de línea incrustados, archivos CRLF y una marca de orden de bytes UTF-8 inicial. Si ambos archivos usan otro separador, indique ese delimitador de un carácter. Las dos entradas deben emplear el mismo delimitador. Los nombres de columna vacíos o duplicados se rechazan porque volverían ambiguos los objetos resultantes. También se devuelve un error claro si falta el encabezado clave en cualquiera de los CSV.

Comprenda la unión izquierda y las claves duplicadas

Para cada registro del CSV izquierdo, la capacidad busca registros del CSV derecho que tengan exactamente el mismo texto de clave. Una coincidencia produce un registro combinado. Si no existe ninguna, se genera igualmente un registro unido: se conservan los campos izquierdos y los campos aportados por la derecha quedan como cadenas vacías. Cuando el archivo derecho contiene varios registros con la misma clave, el registro izquierdo se expande en una fila de salida por cada coincidencia. Este comportamiento de uno a varios sirve para relacionar un cliente con varias suscripciones o un producto con varias existencias, aunque puede aumentar el número de filas. Las claves duplicadas de la izquierda se procesan por separado y mantienen su orden original. Las filas y las coincidencias conservan el orden de origen, lo que garantiza resultados deterministas. La clave compartida aparece una sola vez. Si un encabezado derecho distinto de la clave ya existe a la izquierda, recibe el prefijo right_ para evitar sobrescrituras. Se añaden más prefijos cuando hacen falta para mantener todos los nombres únicos. El array columns muestra el orden y los nombres finales exactos antes de que usted procese joined_rows.

Use los informes de filas sin correspondencia para conciliar datos

El array unmatched_left contiene los registros izquierdos originales cuya clave no encontró equivalente a la derecha. Esas entradas siguen presentes en joined_rows porque se trata de una unión izquierda, pero la lista separada permite enviarlas a corrección, enriquecimiento o revisión. El array unmatched_right contiene registros derechos originales que ninguna fila izquierda utilizó. No aparecen en la tabla unida, aunque suelen revelar datos de referencia obsoletos, identificadores nuevos inesperados o un archivo del periodo equivocado. Los recuentos resumen los tamaños de ambas fuentes, el tamaño expandido del resultado y los totales sin correspondencia. Así, un flujo puede rechazar una importación cuando unmatched_left sea mayor que cero o alertar cuando unmatched_right supere un umbral. La comparación es exacta: no recorta espacios, no normaliza mayúsculas ni reinterpreta números. Por tanto, 001, 1 y 1 con un espacio final son valores distintos. Esta regla conservadora evita asociaciones accidentales. Normalice las claves antes de usar la capacidad si sus reglas permiten tratarlas como equivalentes. Por $0.002 por solicitud mediante la API, puede incorporarla tanto a importaciones repetibles como a investigaciones puntuales.