Konwerter CSV na SQL

Czym jest to narzędzie?

Wypełnianie testowej bazy danych, wczytywanie eksportu arkusza kalkulacyjnego do tabeli lub migracja niewielkiego zbioru danych zwykle zaczyna się tak samo: masz plik CSV, a potrzebujesz SQL. To narzędzie analizuje Twój CSV (używając wiersza nagłówka jako nazw kolumn) i buduje jedną instrukcję INSERT INTO obejmującą wszystkie wiersze danych, gotową do wklejenia do klienta bazy danych.

Wartości tekstowe są ujmowane w pojedyncze cudzysłowy, a wewnętrzne cudzysłowy są maskowane przez ich podwojenie (więc O'Brien staje się O''Brien) — to standardowa reguła maskowania wspólna dla MySQL, PostgreSQL i SQLite. Pusta komórka CSV jest zapisywana jako słowo kluczowe SQL NULL, a nie jako pusty ciąg znaków — to celowy wybór, ponieważ pusta komórka w arkuszu kalkulacyjnym zwykle oznacza „brak wartości”, a nie „pusty tekst”, a to właśnie NULL większość schematów oczekuje w takiej sytuacji.

To, czy wartość zostanie ujęta w cudzysłowy, decyduje prosta heurystyka, a nie prawdziwe wnioskowanie o typie: jeśli komórka po usunięciu białych znaków na końcach wygląda jak zwykła liczba całkowita lub dziesiętna (opcjonalnie z wiodącym znakiem minus), zapisywana jest bez cudzysłowów; wszystko inne — w tym wartości, które jedynie przypominają liczby, ale zawierają dodatkowe znaki, jak kody pocztowe z wiodącymi zerami — jest ujmowane w cudzysłowy jako tekst. Dzięki temu wynik pozostaje uczciwy: to dobry punkt wyjścia do niewielkiego importu, a nie substytut sprawdzenia danych względem rzeczywistego schematu tabeli przed uruchomieniem.

Źródło: parsowanie CSV jest zgodne z RFC 4180, najbliższym odpowiednikiem formalnego standardu CSV; podwajanie pojedynczego cudzysłowu w celu maskowania ciągów znaków to wspólna konwencja udokumentowana przez MySQL, PostgreSQL i SQLite.

Dlaczego warto go używać?

• Konfigurowalna nazwa tabeli — ustaw ją raz, a każdy wiersz będzie się do niej odnosić.
• Poprawne maskowanie ciągów znaków — pojedyncze cudzysłowy wewnątrz wartości są podwajane, dzięki czemu SQL się nie łamie ani nie zostaje obcięty.
• Przewidywalna obsługa NULL — puste komórki stają się NULL zamiast pustego ciągu znaków, zgodnie z tym, jak większość baz danych rozróżnia brakujące dane.
• Powszechna składnia SQL — wygenerowany tutaj INSERT INTO ... VALUES ... działa bez modyfikacji w MySQL, PostgreSQL i SQLite.
• W 100% po stronie klienta — Twoje dane CSV (które mogą zawierać rekordy klientów lub dane biznesowe) są analizowane i konwertowane w przeglądarce i nigdy nigdzie nie są przesyłane.

Jak używać

1. Wklej dane CSV z wierszem nagłówka, np. name,age\nAlice,30\nBob,25.
2. Wprowadź nazwę docelowej tabeli (domyślnie my_table).
3. Kliknij „Generuj SQL”.
4. Skopiuj instrukcję INSERT INTO lub pobierz ją jako plik .sql, a następnie uruchom ją na swojej bazie danych.

Przykład

Wejście

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

Wynik

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

Zwróć uwagę, że puste komórki stały się NULL (a nie pustymi ciągami znaków), a wyglądająca jak liczba wartość age (30) pozostała bez cudzysłowów, podczas gdy każda wartość tekstowa została ujęta w cudzysłowy.

Praktyczne wskazówki

• Wypełnianie lokalnej testowej bazy danych: wyeksportuj małą próbkę jako CSV z arkusza kalkulacyjnego, przekonwertuj ją tutaj i uruchom instrukcję INSERT na swojej bazie danych deweloperskiej.
• Zawsze sprawdzaj typy kolumn przed uruchomieniem wygenerowanego SQL na rzeczywistej tabeli — to narzędzie wnioskuje o wartości liczbowe kontra tekst za pomocą prostej heurystyki, a nie Twojego rzeczywistego schematu, więc kolumna całkowitoliczbowa oczekująca konkretnego formatu może wymagać ręcznej korekty.
• Jeśli masz tysiące wierszy, pojedyncza wielowierszowa instrukcja INSERT generowana przez to narzędzie nadal jest poprawnym SQL, ale bardzo duże instrukcje mogą przekroczyć maksymalny rozmiar pakietu bazy danych — jeśli napotkasz to ograniczenie, najpierw podziel CSV na mniejsze partie.

Dlaczego NULL, a nie pusty ciąg znaków

Częstym błędem przy ręcznym pisaniu skryptów CSV do SQL jest traktowanie każdej brakującej komórki jako pustego ciągu znaków ''. Jest to technicznie poprawny SQL, ale zwykle nie oznacza tego, czego chcesz: kolumna zdefiniowana jako liczba całkowita po prostu odrzuci '', a nawet w kolumnie tekstowej '' po cichu oznacza coś innego niż „nie znamy tej wartości” w większości projektów schematów i zapytań raportowych (sprawdzenie WHERE kolumna IS NULL nie dopasuje pustych ciągów znaków, i odwrotnie). Użycie NULL dla pustych komórek odpowiada semantyce oczekiwanej przez większość baz danych i ORM-ów oraz pozwala uniknąć błędów typu, gdy kolumna liczbowa ma brakujące wartości w niektórych wierszach.

Najczęściej zadawane pytania