CSV zu SQL Konverter

Aus einer CSV ein lauffähiges SQL-Skript machen

Eine CSV von Hand in eine Datenbank zu laden, ist zäh. Du starrst auf ein paar tausend Zeilen und tippst INSERT-Anweisungen einzeln ab, oder du kämpfst mit einem Import-Assistenten und seinen Eigenheiten bei Anführungszeichen und Trennzeichen. Dieser Konverter spart dir das. Du gibst ihm eine CSV, und er gibt dir eine schlichte .sql-Datei zurück: oben ein CREATE TABLE, darunter ein INSERT für jede Zeile.

Gedacht ist er für die schnellen, unspektakulären Aufgaben. Eine lokale Entwicklungsdatenbank befüllen, einen Tabellenexport in eine Tabelle kippen, Beispieldaten in ein Schema bekommen, um mit dem Schreiben von Abfragen anzufangen. Die Ausgabe ist Text, du kannst sie also öffnen, lesen und ändern, bevor du eine einzige Zeile ausführst.

Was im Skript tatsächlich drinsteht

Die Ausgabe hat eine feste Form, und die vorher zu kennen, erspart dir Verwirrung. Ganz oben stehen zwei Kommentarzeilen, die vermerken, dass es sich um einen CSV-Export handelt, samt Zeitstempel der Erstellung. Dann kommt das CREATE TABLE: Die Tabelle heißt immer csv_export, bekommt eine automatisch hochzählende id-Spalte als Primärschlüssel, und jede Kopfzeile deiner CSV wird zu einer eigenen Spalte. Darunter folgt eine Zeile INSERT INTO csv_export (...) VALUES (...); für jede Datenzeile, in der Reihenfolge, in der sie aufgetaucht sind.

Die Spaltennamen stammen aus deiner Kopfzeile, kleingeschrieben, wobei alles, was kein Buchstabe, keine Ziffer und kein Unterstrich ist, durch einen Unterstrich ersetzt wird. Aus einer Kopfzeile wie First Name wird also first_name, und aus Order # wird order__. Wenn zwei deiner Kopfzeilen auf denselben Namen zusammenschrumpfen, landest du mit doppelten Spalten im CREATE TABLE, deshalb lohnt sich vor dem Konvertieren ein kurzer Blick auf die Kopfzeile.

Wie mit deinen Daten umgegangen wird

Deine Datei wird im Browser gelesen und verarbeitet. Das Trennzeichen ermittelt der Konverter selbst aus der Kopfzeile, deshalb laden Dateien mit Komma, Semikolon, Tab und senkrechtem Strich, ohne dass du irgendwas einstellst. Felder in Anführungszeichen und verdoppelte Anführungszeichen darin werden nach dem üblichen CSV-Verfahren gelesen.

Auf der SQL-Seite wird jeder Wert in einfache Anführungszeichen gesetzt, und jedes einfache Anführungszeichen innerhalb eines Werts wird verdoppelt, sodass aus einem Namen wie O'Brien 'O''Brien' wird und die Anweisung nicht kaputtgeht. Aus derselben Regel folgt, dass Zahlen und Datumsangaben als Strings in Anführungszeichen herauskommen, '30' und '2026-07-20', weil jede Spalte TEXT ist. Leere Zellen werden zu einem leeren String, nicht zu NULL. Eine Sache noch, auf die du achten solltest: Einfache Anführungszeichen werden escaped, Backslashes aber nicht, wenn deine Daten also Backslashes enthalten und du mit den Standardeinstellungen von MySQL arbeitest, schau dir diese Werte vor dem Ausführen genau an. UTF-8 bleibt vollständig erhalten und die Tabelle wird als utf8mb4 deklariert, sodass Umlaute, Akzente und nicht-lateinische Schriften die Reise überstehen.

Wo der Konverter aufhört

Das ist ein bewusst schlichter Generator, und eine Handvoll seiner Entscheidungen sind fest verdrahtet. Das offen zu sagen, erspart dir später eine Überraschung.

• Die Tabelle heißt immer csv_export. Du brauchst einen anderen Namen? Benenn sie im Skript um, oder führ nach dem Import ein ALTER TABLE aus.
• Es gibt keine Typerkennung. Jede Spalte kommt als TEXT heraus, auch die, die offensichtlich Ganzzahlen oder Datumsangaben enthalten. Wenn du Spalten mit echten Typen willst, bearbeite das CREATE TABLE, bevor du es ausführst.
• Die Syntax ist auf MySQL und MariaDB zugeschnitten: Namen in Backticks, int(11), ENGINE=InnoDB, utf8mb4. Diese beiden führen es unverändert aus. Postgres, SQL Server, SQLite und Oracle brauchen vorher Anpassungen.
• Die Zeilen werden als einzelne INSERT-Anweisungen geschrieben, nicht als gebündelte Mehrzeilen-Inserts, und alles steht in einer Datei. Für ein paar tausend Zeilen ist das in Ordnung, bei einem sehr großen Export wird das Skript lang.

Meine ehrliche Einschätzung: Behandle das Ergebnis als soliden ersten Entwurf, nicht als fertige Migration. Für eine Wegwerf-Entwicklungstabelle ist es sofort lauffähig. Für alles, was in Produktion geht, öffne es und leg zuerst echte Spaltentypen und einen echten Tabellennamen fest. Diese fünf Minuten sind besser, als später eine Tabelle voller TEXT-Spalten neu zu laden.

Ein konkretes Beispiel

Angenommen, du hast 4.000 Kundendatensätze aus einem alten CRM als customers.csv gezogen, mit Spalten wie Full Name, Email, Signup Date und Plan. Du wirfst sie rein, wählst SQL und bekommst eine Datei namens customers-thefreeconverter.com.sql zurück. Darin steckt ein CREATE TABLE csv_export mit full_name, email, signup_date und plan als TEXT-Spalten plus der id-Schlüssel, gefolgt von 4.000 INSERT-Zeilen. Benenn die Tabelle in customers um, stell signup_date auf DATE und lass es gegen dein lokales MySQL laufen. Das dauert länger zu beschreiben als zu machen.

Das Skript ausführen

Sobald du die .sql-Datei hast, gibst du sie deiner Datenbank so, wie du es sonst auch machst, ob du sie in den mysql-Client pipest oder in ein grafisches Tool einfügst. Die id-Spalte füllt sich beim Einfügen der Zeilen von selbst, die lässt du also in Ruhe. Ein Stolperstein: Das CREATE TABLE hat kein IF NOT EXISTS, deshalb wirft dasselbe Skript beim zweiten Durchlauf einen 'table already exists'-Fehler. Lösch die Tabelle vorher, oder entferne den CREATE-TABLE-Block, wenn du beim zweiten Mal nur die INSERTs willst.

Die Daten vor dem Konvertieren aufräumen

Weil sich die CSV in einem editierbaren Raster öffnet, kannst du sie in Ordnung bringen, bevor überhaupt SQL existiert. Sortier nach einer Spalte, filter auf die Zeilen, die du wirklich willst, benenn eine Kopfzeile um, damit ihr Spaltenname sauberer herauskommt, oder wirf doppelte Zeilen raus. Wenn du es hier reparierst, passen die INSERTs zu dem, was du in der Tabelle haben willst, statt Ballast zu importieren und ihn danach zu löschen.

Wann ein anderes Tool besser passt

Zur Privatsphäre: Die CSV selbst wird nie hochgeladen, weil sie im Browser verarbeitet wird. Beim Bauen des SQL gehen zwar die verarbeiteten Zeilen an den Server, wo die .sql-Datei erzeugt und gerade lange genug vorgehalten wird, dass du sie herunterladen kannst. Diese erzeugten Dateien werden nach etwa zehn Minuten automatisch gelöscht, und danach wird nichts aufbewahrt oder weitergegeben.