CSV-zu-SQL-Konverter

Was ist dieses Tool?

Das Befüllen einer Testdatenbank, das Laden eines Tabellenkalkulations-Exports in eine Tabelle oder die Migration eines kleinen Datensatzes beginnt oft gleich: Sie haben eine CSV-Datei und brauchen SQL. Dieses Tool analysiert Ihre CSV-Datei (wobei die Kopfzeile als Spaltennamen dient) und erstellt eine einzige INSERT-INTO-Anweisung für alle Datenzeilen, bereit zum Einfügen in einen Datenbank-Client.

Textwerte werden in einfache Anführungszeichen gesetzt, wobei interne Anführungszeichen durch Verdopplung maskiert werden (aus O'Brien wird also O''Brien) – die Standard-Escape-Regel, die MySQL, PostgreSQL und SQLite gemeinsam verwenden. Eine leere CSV-Zelle wird als SQL-Schlüsselwort NULL geschrieben, nicht als leere Zeichenkette – das ist eine bewusste Entscheidung, denn eine leere Zelle in einer Tabellenkalkulation bedeutet meist „kein Wert“ und nicht „ein leerer Text“, und genau das erwarten die meisten Datenbankschemata mit NULL.

Ob ein Wert in Anführungszeichen gesetzt wird oder nicht, entscheidet eine einfache Heuristik, keine echte Typinferenz: Sieht die getrimmte Zelle wie eine reine Ganz- oder Dezimalzahl aus (optional mit führendem Minuszeichen), wird sie ohne Anführungszeichen geschrieben; alles andere – auch Werte, die nur wie Zahlen aussehen, aber zusätzliche Zeichen enthalten, etwa Postleitzahlen mit führenden Nullen oder Telefonnummern – wird als Text in Anführungszeichen gesetzt. Das hält die Ausgabe ehrlich: Sie ist ein guter Ausgangspunkt für einen kleinen Import, aber kein Ersatz dafür, Ihre Daten vor der Ausführung gegen das tatsächliche Tabellenschema zu prüfen.

Quelle: Das CSV-Parsing folgt RFC 4180, dem, was einem formalen CSV-Standard am nächsten kommt; die Verdopplung einfacher Anführungszeichen zum Escapen von Strings ist die gemeinsame Konvention, die von MySQL, PostgreSQL und SQLite dokumentiert wird.

Warum sollte man es nutzen?

• Anpassbarer Tabellenname – einmal festlegen, und jede Zeile zielt auf diese Tabelle.
• Korrektes String-Escaping – einfache Anführungszeichen innerhalb von Werten werden verdoppelt, damit das SQL nicht bricht oder abgeschnitten wird.
• Vorhersehbare NULL-Behandlung – leere Zellen werden zu NULL statt zu einer leeren Zeichenkette, passend dazu, wie die meisten Datenbanken fehlende Daten unterscheiden.
• Gängige SQL-Syntax – das hier erzeugte INSERT INTO ... VALUES ... funktioniert unverändert in MySQL, PostgreSQL und SQLite.
• 100 % clientseitig – Ihre CSV-Daten (die Kunden- oder Geschäftsdaten enthalten können) werden in Ihrem Browser analysiert und konvertiert und niemals irgendwohin hochgeladen.

Anleitung

1. Fügen Sie CSV-Daten mit einer Kopfzeile ein, z. B. name,age\nAlice,30\nBob,25.
2. Geben Sie den Namen der Zieltabelle ein (Standard: my_table).
3. Klicken Sie auf „SQL generieren“.
4. Kopieren Sie die INSERT-INTO-Anweisung oder laden Sie sie als .sql-Datei herunter und führen Sie sie gegen Ihre Datenbank aus.

Beispiel

Eingabe

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

Ausgabe

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

Beachten Sie, dass die leeren Zellen zu NULL wurden (nicht zu leeren Zeichenketten) und der zahlenartige age-Wert 30 unquotiert blieb, während jeder Textwert in Anführungszeichen gesetzt wurde.

Praktische Tipps

• Eine lokale Testdatenbank befüllen: Exportieren Sie eine kleine Stichprobe als CSV aus einer Tabellenkalkulation, konvertieren Sie sie hier, und führen Sie die INSERT-Anweisung gegen Ihre Entwicklungsdatenbank aus.
• Prüfen Sie immer die Spaltentypen, bevor Sie das generierte SQL gegen eine echte Tabelle ausführen – dieses Tool erkennt numerisch vs. Text mit einer einfachen Heuristik, nicht anhand Ihres tatsächlichen Schemas, sodass eine Ganzzahl-Spalte mit einem bestimmten erwarteten Format möglicherweise manuell angepasst werden muss.
• Bei Tausenden von Zeilen ist die einzelne, mehrzeilige INSERT-Anweisung, die dieses Tool erzeugt, weiterhin gültiges SQL, aber sehr große Anweisungen können die maximale Paketgröße einer Datenbank überschreiten – teilen Sie die CSV-Datei zunächst in kleinere Chargen auf, falls Sie an diese Grenze stoßen.

Warum NULL und keine leere Zeichenkette

Ein häufiger Fehler beim händischen Schreiben von CSV-zu-SQL-Skripten besteht darin, jede fehlende Zelle als leere Zeichenkette '' zu behandeln. Das ist technisch gültiges SQL, bedeutet aber meist nicht das, was Sie wollen: Eine als Ganzzahl definierte Spalte lehnt '' rundweg ab, und selbst in einer Textspalte bedeutet '' in den meisten Schemadesigns und Reporting-Abfragen stillschweigend etwas anderes als „wir kennen diesen Wert nicht“ (eine WHERE-Spalte-IS-NULL-Prüfung passt nicht auf leere Zeichenketten, und umgekehrt). NULL für leere Zellen zu verwenden entspricht der Semantik, die die meisten Datenbanken und ORMs erwarten, und vermeidet Typfehler, wenn eine numerische Spalte in manchen Zeilen fehlende Werte aufweist.

Häufig gestellte Fragen