Tiontaire CSV go JSON

CSV go JSON: Uirlis Thiontaithe do Tháblaí Comhréidh

Cad é an uirlis seo agus conas a oibríonn sí?

Is uirlis ghréasáin í an leathanach seo a thiontaíonn comhaid CSV (luachanna scartha le camóga, le leathstadanna nó le cluaisíní) go formáid JSON. Nuair a tharraingíonn tú comhad CSV isteach sa leathanach nó a roghnaíonn tú é ó do ghléas, parsáiltear an tábla agus déantar eagar de réada de – gach sraith ag éirí ina réad amháin, agus gach colún ina eochair sa réad sin. Is é JSON an t-aschur réamhshocraithe, ach is féidir an t-ionchur a bheith ina chomhad JSON nó XLSX chomh maith – braitear an fhormáid go huathoibríoch.

Ritheann an phróiseáil go hiomlán sa bhrabhsálaí. Ní sheoltar aon chomhad chuig freastalaí, rud a chiallaíonn go bhfanann sonraí íogaire (mar uimhreacha fóin, seoltaí, nó logaí) slán ar do ghléas féin. Roghnaíonn tú an deighilteoir ceart – camóg, leathstad, nó cluaisín – ag brath ar an gcomhad CSV. Ansin taispeántar réamhamharc ar na sonraí tiontaithe, lena n-áirítear líon na sraitheanna agus na gcolún, chomh maith le méid an chomhaid JSON aschuir. Íoslódálann tú an comhad críochnaithe le cliceáil amháin.

Cad a dhéanann an leathanach seo difriúil?

Tá tréithe ar leith ag baint le tiontú CSV go JSON nach bhfaightear i leathanaigh eile ar an suíomh céanna (mar shampla, JSON go CSV nó Excel go JSON). Seo iad na príomhghnéithe:

• Níl aon chineálacha sonraí sa CSV, ach tá siad sa JSON. Stórálann CSV gach rud mar théacs – níl aon uimhreacha, booleanna, nó null ann go bunúsach. Tacaíonn JSON le raon níos leithne de chineálacha. Anseo, áfach, fanann gach réimse CSV mar théacs sa JSON aschuir. Ní dhéantar uimhreacha (praghsanna, cainníochtaí) a thiontú go huathoibríoch; ná dátaí; ná cóid le ceannnúil mar nialais tosaigh. Má theastaíonn uimhreacha uait, caithfidh tú iad a thiontú de láimh tar éis an íoslódála.

• Ní féidir neadú a chruthú ó CSV. Ós rud é gur tábla comhréidh amháin é CSV, ní féidir JSON ordlathach (réada laistigh de réada) a ghiniúint gan rialacha breise nach gcuireann an uirlis seo i bhfeidhm. Beidh gach réad ag an leibhéal céanna, le heochracha comhionanna ar fud an eagair. Is é sin le rá, ní tháirgtear aon struchtúr “tuismitheoir/leanbh” as an tiontú.

• Tá tábhacht ar leith leis an deighilteoir. Murab ionann agus leathanaigh a phróiseálann JSON nó XLSX, caithfidh tú a shonrú an úsáideann do chomhad CSV camóga, leathstadanna nó cluaisíní. Má roghnaíonn tú an deighilteoir mícheart, parsáiltear an comhad go mícheart agus faigheann tú earráid nó tábla briste.

• Tá camóga leabaithe agus briseadh líne leochaileach. Ní leanann gach comhad CSV rialacha luaíochta go docht. D’fhéadfadh camóga laistigh de réimsí luaite, briseadh líne laistigh de chealla, agus luaíochtaí neamh-éalaithe a bheith ina gcúis le teipeanna parsála. Tá an leathanach seo níos leochailí i leith na bhfadhbanna sin ná formhór na n-uirlisí tiontaithe eile toisc nach ndéanann sé aon iarracht sonraí a ghlanadh nó a athfhormáidiú.

Ionchuir agus aschuir

Ionchur: Comhad CSV amháin (nó JSON/XLSX, ach is CSV é an príomhscéal). Braitear an fhormáid go huathoibríoch. Nuair a bhíonn CSV i gceist, caithfidh an t-úsáideoir an deighilteoir a roghnú ó thrí rogha: camóg, leathstad, nó cluaisín.

Roghanna úsáideora: Tá an fhormáid aschuir socraithe go “JSON” cheana féin. Níl aon rogha eile ann ar an leathanach seo.

Aschur: Comhad JSON ina bhfuil eagar de réada. Taispeánann an leathanach réamhamharc de na sonraí tiontaithe in éineacht le huimhir na sraitheanna agus na gcolún, agus méid an chomhaid JSON aschuir.

Is fiú a thabhairt faoi deara go gcoinnítear na nialais tosaigh sa JSON toisc go gcaitear le gach réimse mar théacs. Mar sin, má tá comhad CSV agat le cóid poist mar “01234”, beidh siad fós mar “01234” sa JSON, ní mar uimhir 1234. Ach má lódálann tú an JSON ina dhiaidh sin i dtimpeallacht a dhéanann clóscríobh uathoibríoch (JavaScript JSON.parse(), mar shampla), d’fhéadfaí na nialais a chailleadh mura láimhseálann tú mar théacs iad.

Rialacha agus cásanna imeallacha

Tá sraith rialacha soiléire ag an leathanach maidir le láimhseáil earráidí agus teorainneacha. Seo na teachtaireachtaí a thaispeántar i gcásanna áirithe:

• Má theipeann ar pharsáil an CSV mar gheall ar earráidí luaíochta nó comhaireamh colún neamhréireach, feicfidh tú: “Níorbh fhéidir an CSV seo a pharsáil.” (Aistriúchán: “This CSV could not be parsed.”)
• Mura bhfuil aon sraitheanna sonraí sa chomhad, léitear: “Níl aon sraitheanna tábla sa chomhad seo.” (“This file has no table rows.”)
• Má sháraíonn líon na sraitheanna nó na gcolún teorainn áirithe (teorainn atá sainithe sa chóras agus nach luaitear go poiblí), feictear: “Tá níos mó ná ‹max› sraitheanna sa tábla seo.” nó “Tá níos mó ná ‹max› colún sa tábla seo.”
• Má tá an comhad rómhór (thar teorainn méide), feicfidh tú: “Tá an comhad seo rómhór. Úsáid comhad faoi ‹max›.” (Is é sin “This file is too large. Use a file under ‹max›.”)
• Mura roghnaíonn tú aon chomhad, feictear: “Roghnaigh comhad amháin ar dtús.” (“Choose one file first.”)
• Má tá an cineál comhaid mícheart (ní CSV, JSON ná XLSX é), feicfidh tú: “Roghnaigh comhad CSV, JSON nó XLSX.” (“Choose a CSV, JSON or XLSX file.”)
• Má thógann an tiontú an iomarca ama, feicfidh tú: “Tá an tiontú seo ag tógáil an iomarca ama. Bain triail as comhad níos lú.” (“This conversion is taking too long. Try a smaller file.”)

Tá sé tábhachtach a thabhairt faoi deara nach ndéanann an uirlis aon iarracht uimhreacha ná dátaí a aithint go huathoibríoch. Fanann gach luach CSV mar théacs sa JSON. Mar sin, má tá uimhreacha agat ar nós “1,000” le camóga mar dheighilteoirí míle, fanfaidh siad mar théacs, ní mar uimhir. Chomh maith leis sin, caomhnaítear briseadh líne laistigh de réimsí luaite CSV mar \n i luachanna teaghrán an JSON.

Cé a bhfuil an uirlis seo ag teastáil uaidh?

Tá an leathanach seo oiriúnach do raon leathan úsáideoirí:

• Forbróirí a fhaigheann onnmhairiú CSV ó bhunachar sonraí nó scarbhileog agus a chaithfidh na sonraí a bheathú isteach in fheidhmchlár JavaScript nó API a bhfuil súil aige le JSON. In ionad scripeáil a scríobh, is féidir leo an comhad a tharraingt isteach anseo agus é a íoslódáil mar JSON.
• Anailísithe sonraí ar mian leo comhad CSV oidhreachta a thiontú (cóid poist le ceannnúil, mar shampla) go JSON agus na nialais tosaigh a choinneáil slán. Ní dhéanann an uirlis seo aon chlóscríobh uathoibríoch, mar sin fanann “00123” mar “00123”.
• Foirne a roinneann sonraí tablacha idir comhghleacaí neamhtheicniúil (a úsáideann Excel/CSV) agus cruach teicneolaíochta a labhraíonn JSON, gan aon sonraí íogaire a uaslódáil chuig freastalaí.
• Aon duine a bhfuil tábla simplí aige (táirgí, teagmhálacha, logaí) a chaithfear a chur isteach in uirlis ghréasáin a léann JSON.
• Mic léinn nó taighdeoirí a chaithfidh CSV a thiontú ina structúr eagraithe le haghaidh tionscadal cláir.

Ceisteanna coitianta

C: An gcaillfear mo nialais tosaigh sa JSON? A: Ní sa chomhad JSON a ghineann an uirlis seo. Coinnítear gach réimse CSV mar théacs, mar sin fanann nialais tosaigh mar atá siad. Ach má lódálann tú an JSON isteach i dtimpeallacht a dhéanann clóscríobh uathoibríoch (mar shampla, JSON.parse() i JavaScript), d’fhéadfadh go n-athrófaí “001” go huimhir 1. Chun é sin a sheachaint, coinnigh na luachanna mar theaghráin tar éis an lódála.

C: Cén fáth a bhfaighim earráid “Níorbh fhéidir an CSV seo a pharsáil”? A: Is iondúil go dtarlaíonn sé seo nuair a bhíonn rialacha luaíochta briste sa CSV – mar shampla, camóga taobh istigh de réimsí nach bhfuil luaite i gceart, nó briseadh líne laistigh de chealla gan luaíocht iomlán. Seiceáil an comhad le heagarthóir téacs chun a chinntiú go bhfuil gach réimse luaite go cuí.

C: An bhfuil teorainn le méid an chomhaid? A: Tá. Má tá an comhad rómhór, feicfidh tú teachtaireacht ag rá “Tá an comhad seo rómhór. Úsáid comhad faoi ‹max›.” Is féidir an teorainn a athrú ó am go chéile; moltar comhaid níos lú ná cúpla megavata a úsáid le haghaidh torthaí tapa.

C: An féidir liom JSON le neadú a chruthú ó CSV? A: Ní féidir leis an uirlis seo. Ós rud é go bhfuil CSV comhréidh, ní féidir ach eagar de réada a ghiniúint a bhfuil na heochracha céanna acu. Má theastaíonn ordlathas uait (mar shampla, “custaiméirí” ina bhfuil “orduithe”), caithfidh tú na sonraí a athstruchtúrú tar éis an tiontaithe.

C: Cén fáth a bhfuil mo chuid uimhreacha (praghsanna, dátaí) fós mar théacs sa JSON? A: Toisc go láimhseálann an uirlis gach réimse CSV mar theaghrán. Ní dhéanann sí aon iarracht uimhreacha a bhrath. Is gné atá ann d’aon ghnó – coimeádann sé sláine na sonraí agus seachnaíonn sé cailliúint faisnéise (mar nialais tosaigh). Is féidir leat na luachanna a thiontú go huimhreacha i do chód féin tar éis duit an JSON a íoslódáil.

C: An bhfuil mo shonraí slán nuair a úsáidim an uirlis seo? A: Tá. Ritheann an tiontú go hiomlán i do bhrabhsálaí – ní sheoltar aon chomhad chuig freastalaí. Tá sé seo thar a bheith úsáideach má tá sonraí íogaire nó pearsanta i gceist nach mian leat a roinnt le seirbhísí seachtracha.