Guide pratiche

Preparare importazioni ed esportazioni di dati affidabili

Un file che si apre non è necessariamente utilizzabile. Scambio affidabile Conserva i significati del campo, distingue i valori sconosciuti da zero e corrisponde ai record senza trattare un'etichetta di visualizzazione come un identificatore fragile.

vedere il metodo

Illustrazione — Preparare importazioni ed esportazioni di dati affidabili
Illustrazione generata dall’IA

Descrivi il contratto di dati

Scrivere un dizionario di campi che copre significato, tipo, unità, stato richiesto e valori mancanti. Definire identificatori e relazioni stabili. Un codice postale, un numero di prodotto o un codice amministrativo possono richiedere una rappresentazione testuale per preservarne il significato.

Specifica la codifica, delimitatore, le date, i fusi orari e le convenzioni decimali. La documentazione del CSV di Python spiega la configurazione del dialetto; Un'estensione di file da sola non impone convenzioni identiche a ogni produttore.

Descrivete il dialetto CSV prima di contare righe. Nel formato RFC 4180 i campi con virgola, virgolette o ritorno a capo sono racchiusi in doppi apici e quelli interni raddoppiati. [CRLF] indica una coppia reale di ritorno carrello e avanzamento riga nel test. Il campo resta parte di un record logico.

Test: intestazione e due record, con CRLF in un campo racchiuso del secondo, occupano quattro righe fisiche, non quattro record. Usate un parser CSV e confrontate i campi. Il lettore Python predefinito restituisce stringhe: 00120 conserva zeri fino a una conversione successiva. Definite vuoti e uso nel foglio di calcolo separatamente; le virgolette CSV non neutralizzano formule.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

CSV con virgole: quattro frammenti; [CRLF] è ritorno reale
Frammento di esempioNumero di campiCampi letti in testo
"Paris, France"1["Paris, France"]
"A ""B"""1["A \"B\""]
"A[CRLF]B"1["A[CRLF]B"]
00120,2["00120", ""]

Costruisci un lotto che sfidi i confini

Includi un nome accentato, un valore mancante opzionale, un identificatore con uno zero iniziale, una descrizione multilinea e una relazione mancante. Aggiungi un formato duplicato e intenzionalmente non valido. Mantieni questo set di dati sintetico e chiaramente etichettato come dati di test.

Decidere se un problema rifiuta una riga, rifiuta il file o produce un'importazione con un rapporto di problema. Evita di segnalare il successo mentre si lascia cadere silenziosamente i campi. Segnala righe accettate, rifiutate e richieste dalla revisione.

Pianificare le autorizzazioni e la sicurezza

Definire chi può esportare, importare e rimuovere un batch. Non inserire le esportazioni riservate in una cartella pubblica per impostazione predefinita. Per i file aperti in fogli di calcolo, rivedere i campi che potrebbero essere interpretati come formule utilizzando un metodo appropriato al software ricevente.

Separare i dati autorizzati dal contesto interno che non dovrebbero viaggiare, come commenti privati, dettagli di contatto non necessari o chiavi tecniche. Utilizzare copie di prova pulite o sintetiche. Archiviazione documenti, conservazione e chi rimuove le esportazioni temporanee.

riconciliare i dati dopo l'elaborazione

Confronta identificatori, relazioni, totali e valori campionati prima e dopo l'elaborazione. Se è richiesto il supporto di andata e ritorno, esportare e reimportare in un ambiente di test, confrontare il significato anziché la sola dimensione del file.

Conserva un backup e registra prima di un'importazione distruttiva. distinguere aggiornamenti, aggiunte ed eliminazioni. Una riga mancante in un'esportazione parziale non significa automaticamente che debba essere eliminata. Concordare queste regole prima di elaborare il database completo.

Documentazione primaria: Python - lettura e scrittura di file CSV.

Lotto fittizio: sei record riportano nell’ordine gli identificativi testuali 00120, 00121, 00120, 00122, 00123 e 00124. Prima dell’importazione, 00121 esiste con un valore da modificare e 00122 è già invariato. La regola scelta accetta la prima occorrenza di una chiave, rifiuta le ripetizioni nel lotto e rifiuta 00123 perché manca una relazione obbligatoria. Il primo passaggio produce 2 creati + 1 aggiornato + 1 invariato + 2 rifiutati = 6 record esaminati.

Dopo il passaggio, la destinazione contiene quattro identificativi: 00120, 00121, 00122 e 00124. Ripetere lo stesso lotto con le stesse regole e senza modifiche intermedie deve produrre 0 creati, 0 aggiornati, 4 invariati e 2 rifiutati. Questo recupero deriva dal contratto d’importazione, non da una proprietà automatica del CSV. Conservate gli zeri iniziali e contate i record logici letti dal parser; un campo tra virgolette può contenere un ritorno a capo.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Bilancio di una prima importazione fittizia di sei record
EsitoNumeroRecord interessati
Creati200120 e 00124
Aggiornato100121: valore diverso dalla destinazione
Invariato100122: valore già identico
Rifiutati2Occorrenza 3: duplicato di 00120; occorrenza 5: relazione assente per 00123

Fornire esportazioni con nomi leggibili nelle lingue pubblicate.

Caso fittizio: un nome contiene accenti. Provate filename, filename*, tipo di contenuto e file salvato. Ripulite nomi provenienti dall’input prima di costruire intestazioni. Questa intestazione non protegge l’accesso né sostituisce verifiche di autorizzazione.

  • Il nome è leggibile, il tipo è corretto e l’input non può aggiungere intestazioni.

Verificare esportazione e reimportazione

Unità di memoria e cavo USB tra due portatili
Illustrazione generata dall’IA · Confronta i campi dopo esportazione e reimportazione.

Caso proposto: dopo esportazione e importazione cambiano zeri iniziali e date, mentre il numero di righe resta uguale.

Usa dati fittizi con accenti, valori vuoti e formati diversi. Confronta i campi uno per uno e registra trasformazioni ammesse o errate.

  • Preparare casi diversi
  • Confrontare i campi importati
  • Registrare le trasformazioni

Documenti di riferimento

Contenuto aggiornato

Riferimenti documentati per questo argomento

Riferimenti documentati per questo argomento
RiferimentoValore o sintassiAmbito
RFC 4180 · CSV
text/csv · "a,b"I campi con virgole, virgolette o ritorni a capo sono racchiusi tra virgolette; quelle interne raddoppiate.
RFC 8259 · JSON
application/json · UTF-8JSON standard non ammette commenti né virgole finali; le stringhe usano virgolette doppie.
RFC 3339 · Date-time
2026-10-22T09:00:00+02:00Lo scarto esplicito collega l’ora locale a UTC; questo esempio non è un appuntamento.

Le date indicano la consultazione delle fonti. Questi riferimenti non costituiscono un audit del sito né una dichiarazione globale di conformità.

Matrice di convalida funzionale per adattarsi al progetto

Questi controlli proposti utilizzano casi fittizi. Decidi quale comportamento è previsto con il team, annota il risultato e assegna discrepanze irrisolte prima della pubblicazione.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Casi di test, risultati attesi e prove utili
Casorisultato attesoProva da mantenere
Accenti, separatori e testo multilineaI valori mantengono il loro significato dopo l'esportazione e la reimportazione.Confronto campo per campo utilizzando un piccolo file di riferimento rappresentativo con valori noti.
zero, vuoto, nullo e assenteI quattro stati seguono regole distinte ove richiesto dal contratto.dizionario di dati e valori effettivamente ricevuti dalla destinazione.
Identificatore ripetutoLa regola scelta distingue la duplicazione, gli aggiornamenti e le varianti legittime.Registro di riga accettato e rifiutato, con un motivo per ogni decisione.
Fallimento a metàIl team sa quali modifiche sono state applicate e come riprendere.stato finale, righe interessate e una procedura di recupero esercitata con dati sintetici.

Domande frequenti

Perché conservare alcuni codici come testo?

Identificano un'entità piuttosto che una quantità. La conversione automatica può perdere gli zeri iniziali o modificare la presentazione. Definire il tipo nel contratto e testare un esempio di confine.

Un conteggio di riga invariato dimostra un'importazione corretta?

No. I conteggi possono corrispondere nonostante i campi persi, le relazioni interrotte o le sostituzioni errate. Confronta identificatori, valori, unità ed errori utilizzando un batch rappresentativo.