Guías prácticas

Preparar importaciones y exportaciones de datos confiables

Un archivo que se abre no es necesariamente utilizable. El intercambio confiable conserva los significados de los campos, distingue valores desconocidos de cero y hace coincidir los registros sin tratar una etiqueta de visualización como un identificador frágil.

Ver el método

Ilustración — Preparar importaciones y exportaciones de datos confiables
Ilustración generada por IA

Describir el contrato de datos

Escriba un diccionario de campo que cubra el significado, el tipo, la unidad, el estado requerido y los valores faltantes. Definir identificadores y relaciones estables. Un código postal, número de producto o código administrativo puede requerir una representación de texto para conservar su significado.

Especifique la codificación, el delimitador, las fechas, las zonas horarias y las convenciones decimales. La documentación CSV de Python explica la configuración del dialecto; Una extensión de archivo por sí sola no impone convenciones idénticas a cada productor.

Describa el dialecto CSV antes de contar líneas. En RFC 4180, los campos con coma, comillas o salto de línea se rodean de comillas dobles y las internas se duplican. [CRLF] en la tabla representa una pareja real de retorno de carro y salto de línea en el archivo de prueba. El campo sigue dentro de un registro lógico.

Prueba: cabecera y dos registros, con CRLF dentro de un campo entrecomillado del segundo, ocupan cuatro líneas físicas, no cuatro registros. Use un analizador CSV y compare campos. El lector Python predeterminado devuelve cadenas: 00120 conserva ceros hasta una conversión posterior. Defina valores vacíos y uso en hojas de cálculo por separado; las comillas CSV no neutralizan fórmulas.

Desplace la tabla horizontalmente para leer todas las columnas. Con el teclado, sitúe el foco en la tabla y use las flechas.

CSV con comas: cuatro fragmentos; [CRLF] indica salto real
Fragmento de ejemploNúmero de camposCampos leídos en texto
"Paris, France"1["Paris, France"]
"A ""B"""1["A \"B\""]
"A[CRLF]B"1["A[CRLF]B"]
00120,2["00120", ""]

Construya un lote que desafíe los límites

Incluya un nombre acentuado, un valor faltante opcional, un identificador con un cero inicial, una descripción de líneas múltiples y una relación faltante. Agregue un duplicado y un formato intencionalmente no válido. Mantenga este conjunto de datos sintético y claramente etiquetado como datos de prueba.

Decida si un problema rechaza una fila, rechaza el archivo o produce una importación con un informe de emisión. Evite informar el éxito mientras se eliminan los campos en silencio. Reporte de filas aceptadas, rechazadas y requeridas por la revisión.

Planificar permisos de intercambio y seguridad

Defina quién puede exportar, importar y eliminar un lote. No coloque las exportaciones confidenciales en una carpeta pública de forma predeterminada. Para los archivos abiertos en hojas de cálculo, revise los campos que podrían interpretarse como fórmulas utilizando un método apropiado para el software de recepción.

Separe los datos autorizados del contexto interno que no deben viajar, como comentarios privados, datos de contacto innecesarios o claves técnicas. Use copias de prueba limpias o sintéticas. Almacenamiento de documentos, retención y OMS elimina las exportaciones temporales.

Conciliar datos después del procesamiento

Compare identificadores, relaciones, totales y valores muestreados antes y después del procesamiento. Si se requiere soporte de ida y vuelta, exporte y vuelva a importar a un entorno de prueba, compare el significado en lugar del tamaño del archivo solo.

Mantenga una copia de seguridad y un registro antes de una importación destructiva. Distinguir actualizaciones, adiciones y supresión. Una fila faltante en una exportación parcial no significa automáticamente que deba eliminarse. Acuerde estas reglas antes de procesar la base de datos completa.

Documentación principal: Python : Lectura y escritura de archivos CSV.

Lote ficticio: seis registros llevan, en este orden, los identificadores textuales 00120, 00121, 00120, 00122, 00123 y 00124. Antes de importar, 00121 existe con un valor que cambiar y 00122 ya tiene el valor correcto. La regla elegida acepta la primera aparición de cada clave, rechaza las repeticiones dentro del lote y rechaza 00123 porque falta una relación obligatoria. El primer pase da 2 creados + 1 actualizado + 1 sin cambios + 2 rechazados = 6 registros examinados.

Después quedan cuatro identificadores en destino: 00120, 00121, 00122 y 00124. Repetir exactamente el mismo lote, con las mismas reglas y sin cambios intermedios, debe dar 0 creados, 0 actualizados, 4 sin cambios y 2 rechazados. Esta recuperación depende del contrato de importación, no de una propiedad automática del CSV. Conserve los ceros iniciales y cuente los registros lógicos del analizador; un campo entre comillas puede contener un salto de línea.

Desplace la tabla horizontalmente para leer todas las columnas. Con el teclado, sitúe el foco en la tabla y use las flechas.

Balance de una primera importación ficticia de seis registros
ResultadoCantidadRegistros afectados
Creados200120 y 00124
Actualizado100121: valor distinto del destino
Sin cambios100122: valor ya idéntico
Rechazados2Aparición 3: duplicado de 00120; aparición 5: relación ausente para 00123

Entregar exportaciones con nombres legibles en los idiomas publicados.

Caso ficticio: un nombre de exportación contiene tildes. Pruebe filename, filename*, tipo de contenido y archivo guardado. Limpie nombres provenientes de entradas antes de construir cabeceras. Esta cabecera no protege el documento ni sustituye las comprobaciones de autorización.

  • El nombre es legible, el tipo corresponde y ninguna entrada puede inyectar otra cabecera.
  • MDN Content-Disposition

    Referencia de presentación en navegador o descarga, incluidos parámetros de nombre de archivo.

Comprobar una exportación de ida y vuelta

Unidad de almacenamiento y cable USB entre dos portátiles
Ilustración generada por IA · Compare los campos tras exportar e importar de nuevo.

Caso propuesto: tras exportar e importar, cambian ceros iniciales y fechas aunque el número de filas siga igual.

Use datos ficticios con acentos, valores vacíos y formatos distintos. Compare cada campo y registre las transformaciones aceptadas o erróneas.

  • Preparar casos variados
  • Comparar campos tras importar
  • Registrar las transformaciones

Documentos de referencia

Contenido actualizado

Referencias documentadas para este tema

Referencias documentadas para este tema
ReferenciaValor o sintaxisAlcance
RFC 4180 · CSV
text/csv · "a,b"Se entrecomillan campos con comas, comillas o saltos de línea; las comillas internas se duplican.
RFC 8259 · JSON
application/json · UTF-8JSON estándar no admite comentarios ni comas finales; las cadenas usan comillas dobles.
RFC 3339 · Date-time
2026-10-22T09:00:00+02:00El desfase explícito relaciona la hora local con UTC; este ejemplo no es una cita.

Las fechas indican la consulta de las referencias. Estos datos no constituyen una auditoría ni una declaración global de conformidad.

Matriz de validación funcional para adaptarse al proyecto

Estos controles propuestos utilizan casos ficticios. Decida qué comportamiento se espera con el equipo, anote el resultado y asigne discrepancias no resueltas antes de la publicación.

Desplace la tabla horizontalmente para leer todas las columnas. Con el teclado, sitúe el foco en la tabla y use las flechas.

Casos de prueba, resultados esperados y evidencia útil
CasoResultado esperadoPrueba para mantener
Acentos, separadores y texto multilíneaLos valores mantienen su significado después de la exportación y reimportación.Comparación de campo por campo utilizando un pequeño archivo de referencia representativo con valores conocidos.
Cero, vacío, nulo y ausenteLos cuatro estados siguen reglas distintas cuando lo requiere el contrato.Diccionario de datos y valores realmente recibidos por el destino.
Identificador repetidoLa regla elegida distingue duplicación, actualizaciones y variantes legítimas.Registro de filas aceptado y rechazado, con un motivo de cada decisión.
falla a la mitadEl equipo sabe qué cambios se aplicaron y cómo reanudar.estado final, filas afectadas y un procedimiento de recuperación ejercido con datos sintéticos.

Preguntas frecuentes

¿Por qué mantener algunos códigos como texto?

Identifican una entidad en lugar de una cantidad. La conversión automática puede perder ceros iniciales o cambiar la presentación. Defina el tipo en el contrato y pruebe un ejemplo de límite.

¿Un recuento de filas sin cambios demuestra una importación correcta?

No. Los recuentos pueden coincidir a pesar de los campos perdidos, las relaciones rotas o los reemplazos incorrectos. Compare identificadores, valores, unidades y errores utilizando un lote representativo.