Pretvornik CSV v SQL

Kaj je to orodje?

Nasajanje testne baze podatkov, nalaganje izvoza preglednice v tabelo ali migracija majhnega nabora podatkov se pogosto začne enako: imaš CSV datoteko in potrebuješ SQL. To orodje razčleni tvoj CSV (uporabi vrstico glave kot imena stolpcev) in zgradi en INSERT INTO stavek, ki zajema vsako podatkovno vrstico, pripravljen za prilepitev v odjemalca baze podatkov.

Besedilne vrednosti so zavite v enojne narekovaje z notranjimi narekovaji, pobegljenimi s podvojitvijo (tako da O'Brien postane O''Brien), kar je standardno pravilo bega, ki si ga delijo MySQL, PostgreSQL in SQLite. Prazna CSV celica je zapisana kot SQL ključna beseda NULL namesto praznega niza — to je namerna izbira, saj prazna celica v preglednici običajno pomeni 'brez vrednosti' namesto 'praznega kosa besedila', NULL pa je tisto, kar večina shem pričakuje za to.

Ali je vrednost narekovana ali puščena gola, določa preprosta hevristika, ne pravo sklepanje o tipu: če obrezana celica izgleda kot navadno celo ali decimalno število (po možnosti z vodilnim minusom), je zapisana brez narekovajev; vse ostalo — vključno z stvarmi, ki le spominjajo na števila z dodatnimi znaki, kot so telefonske številke ali poštne številke z vodilnimi ničlami — je narekovano kot niz. To ohranja izhod pošten: dober je začetek za majhen uvoz, ne nadomestek za preverjanje tvojih podatkov proti dejanski shemi tabele pred zagonom.

Vir: razčlenjevanje CSV sledi RFC 4180, najbližji stvari uradnemu CSV standardu; podvajanje enojnih narekovajev za beg nizov je skupna konvencija, ki jo dokumentirajo MySQL, PostgreSQL in SQLite.

Zakaj ga uporabiti?

• Ime tabele po meri — nastavi ciljno tabelo enkrat, vsaka vrstica pa cilja to tabelo.
• Pravilen beg nizov — enojni narekovaji znotraj vrednosti so podvojeni, tako da se SQL ne pokvari ali skrajša.
• Predvidljiva obravnava NULL — prazne celice postanejo NULL namesto praznega niza, kar ustreza temu, kako večina baz podatkov razlikuje manjkajoče podatke.
• Pogosta SQL sintaksa — oblika INSERT INTO ... VALUES ..., ustvarjena tukaj, deluje nespremenjena v MySQL, PostgreSQL in SQLite.
• 100 % na strani odjemalca — tvoji CSV podatki (ki lahko vsebujejo podatke o strankah ali poslovne podatke) so razčlenjeni in pretvorjeni v tvojem brskalniku ter nikoli naloženi nikamor.

Kako ga uporabljati

1. Prilepi CSV podatke z vrstico glave, npr. name,age\nAlice,30\nBob,25.
2. Vnesi ime ciljne tabele (privzeto my_table).
3. Klikni "Generate SQL".
4. Kopiraj stavek INSERT INTO ali ga prenesi kot .sql datoteko, nato ga zaženi proti svoji bazi podatkov.

Primer

Vnos

name,age,city
Alice,30,
Bob,,NYC

Rezultat

INSERT INTO `my_table` (`name`, `age`, `city`)
VALUES
  ('Alice', 30, NULL),
  ('Bob', NULL, 'NYC');

Opazi, da so prazne celice postale NULL (ne prazni nizi), in da je bila številčna vrednost starosti 30 puščena brez narekovajev, medtem ko je bila vsaka besedilna vrednost narekovana.

Praktični nasveti

• Nasajanje lokalne testne baze podatkov: izvozi majhen vzorec kot CSV iz preglednice, ga pretvori tukaj in zaženi INSERT stavek proti svoji razvojni bazi podatkov.
• Vedno preglej tipe stolpcev pred zagonom ustvarjenega SQL-a proti pravi tabeli — to orodje sklepa o številčnem vs. besedilnem s preprosto hevristiko, ne po tvoji dejanski shemi, tako da lahko stolpec celega števila, ki pričakuje določeno obliko, potrebuje ročno prilagoditev.
• Če imaš na tisoče vrstic, en sam večvrstični INSERT stavek, ki ga to orodje ustvari, je še vedno veljaven SQL, a zelo veliki stavki lahko presežejo največjo velikost paketa baze podatkov — najprej razdeli CSV na manjše serije, če naletiš na to omejitev.

Zakaj NULL in ne prazen niz

Pogosta napaka pri ročnem pisanju skript CSV-v-SQL je obravnavanje vsake manjkajoče celice kot praznega niza ''. To je tehnično veljaven SQL, a običajno ne pomeni tega, kar želiš: stolpec, definiran kot celo število, bo '' popolnoma zavrnil, in celo v besedilnem stolpcu '' tiho pomeni nekaj drugega kot "tega ne vemo" v večini oblikovanj shem in poizvedb poročanja (preverjanje WHERE column IS NULL se ne bo ujemalo s praznimi nizi in obratno). Uporaba NULL za prazne celice ustreza semantiki, ki jo pričakuje večina baz podatkov in ORM-ov, ter se izogne napakam tipa, kadar številčni stolpec pri nekaterih vrsticah pomanjkuje vrednosti.

Pogosta vprašanja