käytännön oppaat

Valmistele luotettava tietojen tuonti ja vienti

Avautuva tiedosto ei välttämättä ole käyttökelpoinen. Luotettava vaihto Säilyttää kenttämerkityksiä, erottaa tuntemattomat arvot nollasta ja vastaa tietueita käsittelemättä näyttötunnistetta herkänä tunnisteena.

Katso menetelmä

Kuvitus — Valmistele luotettava tietojen tuonti ja vienti
Tekoälyllä luotu kuvitus

kuvaile datasopimusta

Kirjoita kenttäsanakirja, joka kattaa merkityksen, tyypin, yksikön, vaaditun tilan ja puuttuvat arvot. Määrittele vakaat tunnisteet ja suhteet. Postinumero, tuotenumero tai hallintokoodi voi vaatia tekstiesityksen sen merkityksen säilyttämiseksi.

Määritä koodaus, erotin, päivämäärät, aikavyöhykkeet ja desimaalikäytännöt. Pythonin CSV-dokumentaatio selittää murteen kokoonpanon; Pelkästään tiedostopääte ei aseta identtisiä käytäntöjä jokaiselle tuottajalle.

Kuvaa CSV-murre ennen rivien laskentaa. RFC 4180:n muodossa pilkun, lainausmerkin tai rivinvaihdon sisältävä kenttä lainataan ja sisäiset lainausmerkit kahdennetaan. [CRLF] tarkoittaa testissä oikeaa paluu- ja rivinvaihtomerkin paria. Kenttä kuuluu yhä yhteen loogiseen tietueeseen.

Testi: otsikko ja kaksi tietuetta, joista toisen lainattu kenttä sisältää CRLF:n, vievät neljä fyysistä riviä, eivät neljää tietuetta. Käytä CSV-jäsennintä ja vertaa kenttiä. Pythonin oletuslukija palauttaa merkkijonoja: 00120 säilyttää nollat myöhempään muunnokseen asti. Määritä tyhjyys ja taulukkolaskentakäyttö erikseen; CSV-lainaus ei neutraloi kaavoja.

Vieritä taulukkoa vaakasuunnassa nähdäksesi kaikki sarakkeet. Siirrä näppäimistöllä kohdistus taulukkoon ja käytä nuolinäppäimiä.

Pilkku-CSV: neljä katkelmaa; [CRLF] on oikea rivinvaihto
EsimerkkikatkelmaKenttien määräLuetut kentät tekstinä
"Paris, France"1["Paris, France"]
"A ""B"""1["A \"B\""]
"A[CRLF]B"1["A[CRLF]B"]
00120,2["00120", ""]

rakentaa erä, joka haastaa rajat

Sisällytä korostettu nimi, valinnainen puuttuva arvo, tunniste, jossa on etunolla, monirivinen kuvaus ja puuttuva relaatio. Lisää kaksoiskappale ja tarkoituksella virheellinen muoto. Pidä tämä tietojoukko synteettisenä ja selvästi merkittynä testitiedoiksi.

Päätä, hylkääkö ongelma yhden rivin, hylkääkö tiedoston vai tuottaako tuonnin ongelmaraportin kanssa. Vältä raportoinnin onnistumisesta pudottamalla kenttiä hiljaa. Raportti hyväksytty, hylätty ja tarkistettavat rivit.

Suunnittele vaihtoluvat ja turvallisuus

Määritä, kuka voi viedä, tuoda ja poistaa erän. Älä sijoita luottamuksellisia vientiä oletusarvoisesti julkiseen kansioon. Laskentataulukoissa avattujen tiedostojen osalta tarkastella kenttiä, jotka voidaan tulkita kaavoiksi vastaanottavalle ohjelmistolle sopivalla menetelmällä.

Erottele valtuutetut tiedot sisäisestä kontekstista, jonka ei pitäisi matkustaa, kuten yksityiset kommentit, tarpeettomat yhteystiedot tai tekniset avaimet. Käytä puhdistettuja tai synteettisiä testikopioita. Asiakirjojen säilytys, säilyttäminen ja se, joka poistaa väliaikaisen viennin.

täsmäyttää tiedot käsittelyn jälkeen

Vertaa tunnisteita, suhteita, kokonaismääriä ja näytteitetyistä arvoista ennen käsittelyä ja sen jälkeen. Jos tarvitaan edestakaisen matkan tukea, vie ja tuo uudelleen testiympäristöön, vertaa merkitystä pelkän tiedostokoon sijaan.

Pidä varmuuskopio ja kirjaa muistiin ennen tuhoisaa tuontia. Erota päivitykset, lisäykset ja poistaminen. Puuttuva rivi osittaisesta viennistä ei automaattisesti tarkoita, että se pitäisi poistaa. Hyväksy nämä säännöt ennen koko tietokannan käsittelyä.

ensisijainen dokumentaatio: Python : CSV-tiedostojen lukeminen ja kirjoittaminen.

Kuvitteellinen erä: kuuden tietueen tekstitunnisteet ovat järjestyksessä 00120, 00121, 00120, 00122, 00123 ja 00124. Ennen tuontia 00121 sisältää muutettavan arvon ja 00122 on jo sama. Valittu sääntö hyväksyy avaimen ensimmäisen esiintymän, hylkää erän sisäiset toistot ja hylkää 00123:n puuttuvan pakollisen suhteen vuoksi. Ensimmäinen ajo tuottaa 2 luotua + 1 päivitetyn + 1 ennallaan olevan + 2 hylättyä = 6 tarkistettua tietuetta.

Ajon jälkeen kohteessa on neljä tunnistetta: 00120, 00121, 00122 ja 00124. Täsmälleen saman erän uusinta samoilla säännöillä ilman muita muutoksia tuottaa 0 luotua, 0 päivitettyä, 4 ennallaan olevaa ja 2 hylättyä tietuetta. Tämä perustuu valittuun tuontisopimukseen, ei CSV:n automaattiseen ominaisuuteen. Säilytä etunollat ja laske jäsentimen loogiset tietueet; lainausmerkeillä rajattu kenttä voi sisältää rivinvaihdon.

Vieritä taulukkoa vaakasuunnassa nähdäksesi kaikki sarakkeet. Siirrä näppäimistöllä kohdistus taulukkoon ja käytä nuolinäppäimiä.

Kuuden tietueen ensimmäisen kuvitteellisen tuonnin täsmäytys
TulosMääräTietueet
Luodut200120 ja 00124
Päivitetty100121: arvo poikkeaa kohteesta
Ennallaan100122: arvo jo sama
Hylätyt2Esiintymä 3: toistuva 00120; esiintymä 5: puuttuva suhde tunnisteelle 00123

Tarjoa viennit luettavilla nimillä julkaistuilla kielillä.

Kuvitteellinen tapaus: vientinimi sisältää ääkkösiä. Testaa filename, filename*, sisältötyyppi ja tallennettu tiedosto. Puhdista syötteestä tulevat nimet ennen otsakkeita. Otsake ei suojaa pääsyä eikä korvaa käyttöoikeustarkistusta.

  • Nimi on luettava, tyyppi oikea eikä syöte voi lisätä ylimääräistä otsaketta.

Vertaa vientiä ja palautustuontia

Tallennuslaite ja USB-kaapeli kahden kannettavan välissä
Tekoälyllä luotu kuvitus · Vertaa kenttiä viennin ja palautustuonnin jälkeen.

Ehdotettu esimerkki: vienti ja tuonti muuttavat alkunollia ja päivämääriä, vaikka rivimäärä pysyy samana.

Käytä keksittyjä tietoja, joissa on tarkkeita, tyhjiä arvoja ja erilaisia muotoja. Vertaa kenttiä yksitellen ja kirjaa sallitut sekä virheelliset muutokset.

  • Valmistele erilaisia tapauksia
  • Vertaa tuotuja kenttiä
  • Kirjaa muunnokset

viiteasiakirjat

Sisältö päivitetty

Aiheen dokumentoidut viitekohdat

Aiheen dokumentoidut viitekohdat
ViiteArvo tai syntaksiSoveltamisala
RFC 4180 · CSV
text/csv · "a,b"Pilkun, lainausmerkin tai rivinvaihdon sisältävät kentät lainataan; sisäiset lainausmerkit kahdennetaan.
RFC 8259 · JSON
application/json · UTF-8Tavallinen JSON ei salli kommentteja tai loppupilkkuja; merkkijonot käyttävät kaksinkertaisia lainausmerkkejä.
RFC 3339 · Date-time
2026-10-22T09:00:00+02:00Selkeä aikasiirtymä yhdistää paikallisajan UTC-aikaan; esimerkki ei ole ajanvaraus.

Päivämäärät kertovat lähteiden tarkistamisesta. Tiedot eivät ole sivuston auditointi tai yleinen vaatimustenmukaisuusvakuutus.

toiminnallinen validointimatriisi, joka mukautuu projektiin

Nämä ehdotetut kontrollit käyttävät kuvitteellisia tapauksia. Päätä, mitä käyttäytymistä tiimin kanssa odotetaan, kirjoita tulos muistiin ja määritä ratkaisemattomia eroja ennen julkaisemista.

Vieritä taulukkoa vaakasuunnassa nähdäksesi kaikki sarakkeet. Siirrä näppäimistöllä kohdistus taulukkoon ja käytä nuolinäppäimiä.

testitapaukset, odotetut tulokset ja hyödyllisiä todisteita
Asiaodotettu tulostodiste säilyttää
aksentit, erottimet ja monirivinen tekstiArvot säilyttävät merkityksensä viennin ja uudelleentuonnin jälkeen.Kenttä kentältä vertailu käyttämällä pientä edustavaa viitetiedostoa tunnetuilla arvoilla.
nolla, tyhjä, nolla ja poissaNeljä osavaltiota noudattavat erillisiä sääntöjä, jos sopimus sitä edellyttää.datasanakirja ja kohteen tosiasiallisesti vastaanottamat arvot.
toistuva tunnisteValittu sääntö erottaa päällekkäisyydet, päivitykset ja lailliset muunnelmat.Hyväksytty ja hylätty riviloki, jokaisella päätöksellä oli syy.
epäonnistuminen puolivälissäTiimi tietää, mitä muutoksia sovellettiin ja miten niitä voidaan jatkaa.lopullinen tila, Affected rivit ja palautusmenettely, jota käytetään synteettisillä tiedoilla.

Usein kysyttyjä kysymyksiä

Miksi säilyttää joitain koodeja tekstinä?

Ne tunnistavat kokonaisuuden pikemminkin kuin määrän. Automaattinen muunnos voi menettää etunollat tai muuttaa esitystä. Määritä tyyppi sopimuksessa ja testaa rajaesimerkki.

Osoittaako muuttumaton rivien määrä oikean tuonnin?

Ei. Laskut voivat vastata kadonneista kentistä, katkenneista suhteista tai virheellisistä vaihdoista huolimatta. Vertaa tunnisteita, arvoja, yksiköitä ja virheitä edustavan erän avulla.