Konvertor CSV na SQL

Čo je tento nástroj?

Naplnenie testovacej databázy, načítanie exportu z tabuľkového procesora do tabuľky alebo migrácia menšej dátovej sady často začína rovnako: máte CSV súbor a potrebujete SQL. Tento nástroj spracuje váš CSV (pričom hlavičkový riadok použije ako názvy stĺpcov) a vytvorí jeden príkaz INSERT INTO pokrývajúci všetky dátové riadky, pripravený na vloženie do databázového klienta.

Textové hodnoty sa uzatvárajú do jednoduchých úvodzoviek so zdvojenými vnútornými úvodzovkami (takže O'Brien sa stane O''Brien), čo je štandardné pravidlo escapovania spoločné pre MySQL, PostgreSQL a SQLite. Prázdna CSV bunka sa zapíše ako SQL kľúčové slovo NULL namiesto prázdneho reťazca — je to zámerná voľba, pretože prázdna bunka v tabuľke zvyčajne znamená "žiadna hodnota", nie "prázdny kúsok textu", a práve NULL očakáva väčšina schém.

To, či sa hodnota uzatvorí do úvodzoviek alebo ponechá bez nich, sa rozhoduje jednoduchou heuristikou, nie skutočnou detekciou typu: ak orezaná bunka vyzerá ako obyčajné celé alebo desatinné číslo (voliteľne so znamienkom mínus na začiatku), zapíše sa bez úvodzoviek; všetko ostatné — vrátane vecí, ktoré sa len podobajú na čísla s ďalšími znakmi, ako telefónne čísla alebo PSČ s nulami na začiatku — sa uzatvorí do úvodzoviek ako reťazec. Výstup tak zostáva čestný: je to dobrý východiskový bod pre menší import, nie náhrada za overenie vašich dát oproti skutočnej schéme tabuľky pred spustením.

Zdroj: parsovanie CSV sa riadi RFC 4180, čo je najbližšie k formálnemu CSV štandardu; zdvojovanie jednoduchých úvodzoviek pri escapovaní reťazcov je spoločná konvencia zdokumentovaná v MySQL, PostgreSQL a SQLite.

Prečo ho používať?

• Vlastný názov tabuľky — nastavte cieľovú tabuľku raz a každý riadok bude smerovať do nej.
• Správne escapovanie reťazcov — jednoduché úvodzovky vo vnútri hodnôt sú zdvojené, takže SQL sa nepokazí ani neskráti.
• Predvídateľné spracovanie NULL — prázdne bunky sa menia na NULL namiesto prázdneho reťazca, tak ako väčšina databáz rozlišuje chýbajúce dáta.
• Bežná SQL syntax — tvar INSERT INTO ... VALUES ... generovaný tu funguje bez úprav v MySQL, PostgreSQL a SQLite.
• 100% na strane klienta — vaše CSV dáta (ktoré môžu obsahovať záznamy o zákazníkoch alebo firemné údaje) sa spracujú a konvertujú vo vašom prehliadači a nikdy sa nikam neodosielajú.

Ako sa používa

1. Vložte CSV dáta s hlavičkovým riadkom, napr. name,age\nAlice,30\nBob,25.
2. Zadajte názov cieľovej tabuľky (predvolene my_table).
3. Kliknite na "Generovať SQL".
4. Skopírujte príkaz INSERT INTO alebo ho stiahnite ako .sql súbor a potom ho spustite vo vašej databáze.

Príklad

Vstup

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

Výstup

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

Všimnite si, že prázdne bunky sa zmenili na NULL (nie na prázdne reťazce) a číselne vyzerajúca hodnota veku 30 zostala bez úvodzoviek, zatiaľ čo každá textová hodnota bola do úvodzoviek uzatvorená.

Praktické tipy

• Naplnenie lokálnej testovacej databázy: exportujte malú vzorku ako CSV z tabuľkového procesora, skonvertujte ju tu a spustite príkaz INSERT vo vašej vývojovej databáze.
• Pred spustením vygenerovaného SQL kódu na reálnej tabuľke vždy skontrolujte typy stĺpcov — tento nástroj odhaduje číselné vs. textové hodnoty jednoduchou heuristikou, nie podľa vašej skutočnej schémy, takže stĺpec typu integer očakávajúci konkrétny formát môže vyžadovať ručnú úpravu.
• Ak máte tisíce riadkov, jeden viacriadkový príkaz INSERT, ktorý tento nástroj generuje, je stále platné SQL, no veľmi veľké príkazy môžu naraziť na maximálnu veľkosť paketu databázy — ak na tento limit narazíte, rozdeľte CSV najprv na menšie dávky.

Prečo NULL a nie prázdny reťazec

Bežná chyba pri ručnom písaní skriptov na konverziu CSV na SQL je spracovanie každej chýbajúcej bunky ako prázdneho reťazca ''. To je technicky platné SQL, no zvyčajne to neznamená to, čo chcete: stĺpec definovaný ako integer '' priamo odmietne, a aj v textovom stĺpci '' vo väčšine návrhov schém a reportovacích dotazov ticho znamená niečo iné než "túto hodnotu nepoznáme" (kontrola WHERE column IS NULL nezachytí prázdne reťazce, a naopak). Použitie NULL pre prázdne bunky zodpovedá sémantike, ktorú očakáva väčšina databáz a ORM, a zabraňuje chybám typu, keď numerický stĺpec má v niektorých riadkoch chýbajúce hodnoty.

Časté otázky