CSV u SQL pretvarač

Što je ovaj alat?

Punjenje testne baze podataka, učitavanje izvoza iz proračunske tablice u tablicu ili migracija manjeg skupa podataka često počinje na isti način: imate CSV datoteku i trebate SQL. Ovaj alat parsira vaš CSV (koristeći redak zaglavlja kao nazive stupaca) i gradi jednu INSERT INTO naredbu koja pokriva svaki redak podataka, spremnu za lijepljenje u klijent baze podataka.

Tekstualne vrijednosti omotavaju se jednostrukim navodnicima s unutarnjim navodnicima izbjegnutim udvostručavanjem (tako O'Brien postaje O''Brien), što je standardno pravilo za izbjegavanje koje dijele MySQL, PostgreSQL i SQLite. Prazna CSV ćelija zapisuje se kao SQL ključna riječ NULL umjesto praznog niza — to je namjeran izbor, jer prazna ćelija u proračunskoj tablici obično znači 'nema vrijednosti', a ne 'prazan komad teksta', a NULL je ono što većina shema očekuje za to.

Hoće li vrijednost biti pod navodnicima ili ne odlučuje jednostavna heuristika, ne stvarno zaključivanje tipa: ako obrezana ćelija izgleda kao obični cijeli ili decimalni broj (opcionalno s vodećim predznakom minus), zapisuje se bez navodnika; sve ostalo — uključujući stvari koje samo podsjećaju na brojeve s dodatnim znakovima, poput telefonskih brojeva ili poštanskih brojeva s vodećim nulama — navodi se kao tekst. Ovo održava izlaz iskrenim: dobra je polazna točka za manji uvoz, a ne zamjena za provjeru vaših podataka u odnosu na stvarnu shemu tablice prije pokretanja.

Izvor: CSV parsiranje slijedi RFC 4180, najbliže formalnom CSV standardu; udvostručavanje jednostrukih navodnika za izbjegavanje niza zajednička je konvencija koju dokumentiraju MySQL, PostgreSQL i SQLite.

Zašto ga koristiti?

• Prilagođeni naziv tablice — postavite ciljanu tablicu jednom, a svaki redak cilja tu tablicu.
• Ispravno izbjegavanje niza — jednostruki navodnici unutar vrijednosti udvostručuju se kako se SQL ne bi pokvario ili skratio.
• Predvidljivo rukovanje NULL vrijednostima — prazne ćelije postaju NULL umjesto praznog niza, u skladu s time kako većina baza podataka razlikuje nedostajuće podatke.
• Uobičajena SQL sintaksa — oblik INSERT INTO ... VALUES ... ovdje generiran radi bez izmjena u MySQL-u, PostgreSQL-u i SQLite-u.
• 100% na strani klijenta — vaši CSV podaci (koji mogu uključivati podatke o klijentima ili poslovne podatke) parsiraju se i pretvaraju u vašem pregledniku i nikad se ne šalju nikamo.

Kako ga koristiti

1. Zalijepite CSV podatke s retkom zaglavlja, npr. name,age\nAlice,30\nBob,25.
2. Unesite naziv ciljane tablice (zadano je my_table).
3. Kliknite "Generate SQL".
4. Kopirajte INSERT INTO naredbu ili je preuzmite kao .sql datoteku, a zatim je pokrenite u svojoj bazi podataka.

Primjer

Ulaz

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

Izlaz

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

Primijetite da su prazne ćelije postale NULL (ne prazni nizovi), a numerička vrijednost age 30 ostala je bez navodnika dok su sve tekstualne vrijednosti navedene pod navodnicima.

Praktični savjeti

• Punjenje lokalne testne baze podataka: izvezite mali uzorak kao CSV iz proračunske tablice, pretvorite ga ovdje i pokrenite INSERT naredbu u svojoj razvojnoj bazi podataka.
• Uvijek pregledajte tipove stupaca prije pokretanja generiranog SQL-a u stvarnoj tablici — ovaj alat zaključuje numeričko naspram tekstualnog jednostavnom heuristikom, ne vašom stvarnom shemom, pa stupac cijelog broja koji očekuje određeni format može trebati ručnu prilagodbu.
• Ako imate tisuće redaka, jedna INSERT naredba s više redaka koju ovaj alat generira i dalje je valjan SQL, ali vrlo velike naredbe mogu naići na maksimalnu veličinu paketa baze podataka — prvo podijelite CSV u manje serije ako naiđete na to ograničenje.

Zašto NULL, a ne prazan niz

Česta pogreška pri ručnom pisanju skripti za CSV-u-SQL je tretiranje svake nedostajuće ćelije kao praznog niza ''. To je tehnički valjan SQL, ali obično ne znači ono što želite: stupac definiran kao cijeli broj u potpunosti će odbiti '', a čak i u tekstualnom stupcu, '' tiho znači nešto drugačije od 'ne znamo tu vrijednost' u većini dizajna shema i izvještajnih upita (provjera WHERE column IS NULL neće se podudarati s praznim nizovima, i obrnuto). Korištenje NULL za prazne ćelije odgovara semantici koju očekuje većina baza podataka i ORM-ova, i izbjegava pogreške tipa kada numerički stupac ima nedostajuće vrijednosti u nekim recima.

Često postavljana pitanja