JSON CSV-ks teisendamine: miks see tööriist erineb ja kuidas see töötab
See leht muudab JSON-faili CSV-failiks. Erinevalt paljudest sarnastest tööriistadest ei laadi see andmeid ühelegi serverisse – kogu töötlemine toimub sinu brauseris. See tähendab, et tundlikud andmed ei lahku kunagi sinu seadmest. Teine oluline erinevus on see, et teisendus lihtsustab hierarhilise ja tüübitud andmestruktuuri (JSON) tasapinnaliseks ja tüübituks tabeliks (CSV). See toob kaasa mitmeid tagajärgi, mida iga kasutaja peab mõistma.
JSON toetab objekte, massiive, numbreid, tõeväärtusi ja null-väärtusi pesastatud struktuurides. CSV-l puuduvad tüübid, pesastused ja lehed. Teisendamisel kaob kogu tüübiteave, pesastatud struktuur ja vormindus. Selle asemel tekib lame tabel, kus kõik väärtused on stringid.
Kuidas pesastatud JSON muudetakse CSV-ks: punkttee ja massiivid
JSON-i hierarhilise olemuse tõttu tuleb see teisendamiseks "lapikuks teha". Tööriist kasutab selleks punkttee (dot-path) märgistust. Kui JSON sisaldab objekti sees objekti, näiteks {"address": {"city": "Tallinn", "street": "Pikk"}}, siis CSV veerupealkirjadeks saavad address.city ja address.street. See võimaldab säilitada struktuuri tähendust ka lamedas tabelis.
Massiivi puhul on kaks võimalust. Kui JSON on massiiv objektidest (näiteks API vastus [{...}, {...}]), siis iga objektist saab üks rida ja objektide võtmetest veerud. Kui JSON on massiiv massiividest (näiteks [["a","b"],["c","d"]]), siis iga sisemine massiiv muutub reaks ja elemendid veergudeks – sel juhul objekti võtmeid pole.
Oluline on, et JSON peab olema tabelikujuline – see tähendab kas üks massiiv objekte või üks massiiv massiive. Kui fail ei vasta sellele nõudele, kuvatakse veateade: "This JSON is invalid or not table-shaped.".
CSV eraldajad: koma, semikoolon või taabel
CSV-faili eraldaja mõjutab seda, kuidas veerud üksteisest eraldatakse. Tööriist pakub kolme valikut: koma (,), semikoolon (;) ja taabel (\t). Koma on kõige levinum, kuid paljud mitteingliskeelsed lokatsioonid kasutavad vaikimisi semikoolonit, sest koma on sealsetes arvudes kümnendkoha eraldaja. Taabel on kasulik, kui andmed ise sisaldavad komasid ja soovid vältida nende segiajamist eraldajaga.
Eraldaja valik mõjutab ka CSV-faili ühilduvust teiste programmidega. Excel avab komaga eraldatud CSV-faili automaatselt, kuid kui sinu süsteemi lokatsioon eeldab semikoolonit, võib tekkida vajadus see käsitsi määrata.
Andmetüüpide kadu ja jutumärgistuse reeglid
JSON-is on andmetüübid selgelt määratud: 123 on number, true on tõeväärtus, null on tühi väärtus. CSV-s on kõik väärtused stringid, seega teisendamisel muutuvad numbrid ja tõeväärtused tekstiks. See tähendab, et kui avad CSV-faili Excelis, võib number 00123 muutuda 123-ks, kuna juhtivad nullid kaovad. Sama juhtub ka tõeväärtustega: true muutub stringiks "true".
CSV kasutab jutumärgistust, et kaitsta eraldajaid ja reavahetusi väärtuste sees. Tööriist rakendab automaatselt CSV jutumärgistuse reegleid: kui väärtuses esineb koma, reavahetus või jutumärk, pannakse kogu väärtus jutumärkidesse ja jutumärgid ise dubleeritakse (" → "").
Näide: JSON-i väärtus "Tere, maailm!" muutub CSV-s "Tere, maailm!" – koma sees ei riku tabelit, sest jutumärgid eraldavad seda.
Veaolukorrad ja piirangud
Tööriistal on mitmeid piiranguid ja veateateid, mis on mõeldud kasutaja juhendamiseks ja vigade vältimiseks.
- Faili suuruse piirang: Kui fail on liiga suur, kuvatakse teade: "This file is too large. Use a file under ‹max›.". Faili suurus peab olema alla 8 MB.
- Ridade ja veergude piirang: Kui tabelis on rohkem kui 10 000 rida või 200 veergu, kuvatakse vastavalt: "This table has more than ‹max› rows." ja "This table has more than ‹max› columns.".
- Vigased failid: Kui üritad teisendada faili, mis pole JSON, või kui sa ei vali enne teisendamist ühtegi faili, näed vastavaid teateid: "Choose a CSV, JSON or XLSX file." ja "Choose one file first.".
- Aegumine: Kui teisendus võtab liiga kaua aega (umbes 12 sekundit), kuvatakse teade: "This conversion is taking too long. Try a smaller file.".
- Tühistamine: Kasutaja saab teisenduse tühistada, mis kutsub esile "Conversion cancelled.".
- Muud vead: Üldine veateade "Could not convert this file." ilmub siis, kui esineb midagi ettenägematut.
Kes vajab seda tööriista ja miks
See tööriist on mõeldud inimestele, kes töötavad JSON-failidega (näiteks API vastustest) ja soovivad neid analüüsida tabelarvutusprogrammides nagu Excel või Google Sheets, või importida andmebaasi. Tüüpiline kasutusjuht on kiire andmete teisendamine ilma koodi kirjutamata.
Eriline eelis on privaatsus: kuna andmeid ei laadita serverisse, sobib tööriist hästi tundlike andmete (isikuandmed, ärisaladused) töötlemiseks. Samuti on see kasulik, kui töötad võrguta keskkonnas või soovid vältida piiratud ribalaiust.
Teiseks oluliseks kasutajagrupiks on inimesed, kes vajavad erinevaid eraldajaid. Kui töötad Euroopas, kus Exceli vaikeeraldaja on sageli semikoolon, siis komaeraldajaga CSV võib põhjustada segadust. Tööriist võimaldab seda kohe valida.
Kolmandaks on see kasulik kiireks prototüüpimiseks andmevoogudes – näiteks arendajad, kes soovivad JSON-vastuse kiiresti CSV-sse teisendada ja seda edasi töödelda.
Korduma kippuvad küsimused (FAQ)
1. Miks kaovad minu JSON-faili numbrid nullid CSV-s?
JSON-numbrid ei saa sisaldada juhtivaid nulle. Kui sinu lähteväärtus on "0123" (string), jääb see 0123-ks. Kui see on 0123 numbrilise literaalina, käsitlevad JSON-parserid seda kui numbrit 123, ja tööriist väljastab 123. Kui vajad nulli säilitamist, salvesta sellised väärtused JSON-is stringidena.
2. Kas ma saan teisendada JSON-faili, mis sisaldab pesastatud objekte mitme tasandiga?
Jah. Pesastatud objektid iga massiivi elemendi sees lamedatakse punkttee märgistusega (nt a.b.c). Üksik tipptaseme objekt teisendatakse ühe rea tabeliks. Kui vajalik tabel asub sügaval suuremas struktuuris, eralda see massiiv esmalt – vastasel juhul satub see ühe lahtrisse JSON-tekstina.
3. Kas ma saan teisendada JSON-faili, mis on lihtsalt objekt (mitte massiiv)?
See teisendatakse ühe rea tabeliks: iga tipptaseme võti muutub veeruks. Objekti massiivi pakkimine ([{...}]) annab sama tulemuse.
4. Kas teisendamine on ohutu? Kas andmed laaditakse kuhugi üles? Jah. Kogu töötlemine toimub sinu brauseris. Ühtegi faili ega andmeid ei saadeta serverisse.
5. Mis juhtub, kui minu CSV-fail sisaldab komadega väärtusi?
CSV jutumärgistus on kohustuslik, kui väli sisaldab eraldajat, jutumärki või reavahetust. Tööriist rakendab RFC 4180 jutumärgistust automaatselt. Jututärgid väärtuse sees dubleeritakse (nt Ta ütles "Tere" muutub "Ta ütles ""Tere""").
6. Kas ma saan teisendada suuri faile, näiteks 100 MB JSON-i? Piirang on 8 MB; suuremad failid lükatakse tagasi teatega "This file is too large. Use a file under ‹max›.". Tabelid on piiratud ka 10 000 rea ja 200 veeruga. Teisendus, mis kestab kauem kui umbes 12 sekundit, peatatakse teatega "This conversion is taking too long. Try a smaller file.".