SQL INSERT: Anführungszeichen escapen – warum es nötig ist

Inhalt
- Warum SQL Zeichenketten in einfache Anführungszeichen setzt
- Was passiert, wenn ein Wert ein einfaches Anführungszeichen enthält
- Warum das Anführungszeichen doppelt geschrieben werden muss
- Wie das Tool diese Entscheidung für jeden Wert übernimmt
- Nicht jede Spalte wird in Anführungszeichen gesetzt
- Zusammenfassung
- Häufig gestellte Fragen
Wenn Sie eine CSV-Datei in SQL-INSERT-Anweisungen überführen, kann plötzlich ein Syntaxfehler auftreten. Die Ursache ist meist ein einziges Hochkomma (Apostroph) in einem Wert. Enthält ein Produktname zum Beispiel einen Apostroph, etwa "Women's Shoes", bringt dieser Wert den gesamten restlichen Befehl durcheinander, sobald Sie ihn unverändert in die SQL-Anweisung einsetzen.
Das liegt nicht an fehlerhaften Daten. Es ist eine zwangsläufige Folge davon, wie SQL Zeichenketten darstellt. Wer das Prinzip kennt, versteht, warum das Escaping nötig ist und warum man es besser automatisch bei der Umwandlung erledigen lässt, statt Werte einzeln von Hand zu korrigieren.
Kurzfassung ① SQL setzt Zeichenkettenwerte in ein Paar einfacher Anführungszeichen und markiert damit: „Von hier bis hier ist Text." ② Steckt in einem Wert ein einfaches Anführungszeichen, hält der SQL-Parser die Zeichenkette an dieser Stelle für beendet. ③ Deshalb muss ein einfaches Anführungszeichen im Wert doppelt geschrieben werden. Nur so gilt es als echtes Zeichen und nicht als Ende der Zeichenkette.
Warum SQL Zeichenketten in einfache Anführungszeichen setzt
In SQL-Anweisungen stehen Textwerte immer in einem Paar einfacher Anführungszeichen. Wenn Sie etwa „Monitor" in eine Namensspalte eintragen, schreiben Sie 'monitor' mit einfachen Anführungszeichen davor und dahinter. Nur so erkennt die Datenbank, dass es sich um Text im wörtlichen Sinn handelt und nicht um eine Zahl oder einen Befehl.
Diese einfachen Anführungszeichen sind keine Dekoration, sondern Begrenzer, die Anfang und Ende der Zeichenkette markieren. Trifft der Parser auf das öffnende Anführungszeichen, erkennt er: „Ab jetzt beginnt der Textbereich." Beim nächsten einfachen Anführungszeichen schließt er daraus: „Hier ist der Text zu Ende." Diese Regel gilt unabhängig vom verwendeten SQL-Dialekt.
Was passiert, wenn ein Wert ein einfaches Anführungszeichen enthält
Das Problem entsteht, wenn der Wert selbst ein einfaches Anführungszeichen enthält. Nehmen wir an, der Produktname lautet "Women's Shoes". Übernehmen Sie ihn unverändert, entsteht die Anweisung VALUES ('Women's Shoes').
Der Parser liest diese Anweisung anders. Die Zeichenkette beginnt beim ersten einfachen Anführungszeichen. Beim zweiten, direkt hinter „Women", nimmt er an, die Zeichenkette sei hier zu Ende. Der Rest s Shoes' steht dann als loser Textbrocken außerhalb der Zeichenkette. An einer Stelle, an der der Parser ein Komma oder eine schließende Klammer erwartet, steht plötzlich ein unpassendes Zeichen, und es kommt zu einem Syntaxfehler.
Warum das Anführungszeichen doppelt geschrieben werden muss
Die Lösung besteht darin, das einfache Anführungszeichen im Wert zweimal hintereinander zu schreiben. Statt 'Women's Shoes' muss es also 'Women''s Shoes' heißen. Stehen zwei Anführungszeichen direkt nacheinander, deutet der Parser das nicht als „Zeichenkette beendet", sondern als „ein tatsächlich in der Zeichenkette enthaltenes einfaches Anführungszeichen".
Das ist kein Kniff eines einzelnen Programms, sondern die im SQL-Standard festgelegte Escape-Regel. Bevor Sie einen Wert in eine SQL-Anweisung einsetzen, müssen Sie deshalb stets prüfen, wie viele einfache Anführungszeichen er enthält und ob jedes davon verdoppelt wurde. Nur dann bleibt die Syntax intakt. Hat eine CSV-Datei mehrere hundert Zeilen und enthalten nur wenige davon einen Apostroph, ist diese Prüfung von Hand für jeden Wert mühsam, kaum sichtbar und leicht zu übersehen.
Fügen Sie Ihr CSV ein und erhalten Sie sofort CREATE TABLE- und INSERT-Anweisungen, in denen einfache Anführungszeichen in den Werten automatisch escaped sind.

Wie das Tool diese Entscheidung für jeden Wert übernimmt
Der CSV → SQL Generator ersetzt vor dem Einsetzen in die SQL-Anweisung jedes einfache Anführungszeichen in einem Wert automatisch durch zwei. Ganz gleich, wie viele Apostrophe eine CSV-Zeile enthält und in welcher Zeile oder Spalte sie stehen: Die Umwandlung behandelt alle gleich. Sobald Sie Ihre CSV-Daten einfügen, enthält die erzeugte INSERT-Anweisung die Werte daher bereits escaped. Sie müssen nicht mehr jeden Wert öffnen und per Augenschein nach Anführungszeichen suchen.
Nicht jede Spalte wird in Anführungszeichen gesetzt
Diese Behandlung gilt allerdings nur für Spalten, die als Text erkannt wurden. Das Tool prüft die Werte jeder CSV-Spalte: Haben alle die Form einer Zahl, wird die Spalte als Ganzzahl oder Dezimalzahl eingestuft, bei true/false oder yes/no als Boolean. Spalten, die so als Nicht-Text erkannt werden, setzt das Tool gar nicht erst in einfache Anführungszeichen, ihre Werte stehen unverändert in der SQL-Anweisung. Das Problem mit dem einfachen Anführungszeichen tritt nur bei Zeichenkettenliteralen auf, daher gibt es bei Zahl- und Boolean-Spalten nichts zu escapen. Umgekehrt werden nur Spalten in Anführungszeichen gesetzt, die wegen enthaltener Buchstaben als Text erkannt wurden, und nur dort werden einfache Anführungszeichen escaped.
Zusammenfassung
- SQL setzt Zeichenkettenwerte in ein Paar einfacher Anführungszeichen und markiert so Anfang und Ende des Textes.
- Steckt im Wert ein einfaches Anführungszeichen, hält der Parser diese Stelle für das Ende der Zeichenkette, und der Rest der Anweisung führt zu einem Syntaxfehler.
- Die Lösung ist, das einfache Anführungszeichen im Wert doppelt zu schreiben. Das ist die im SQL-Standard festgelegte Escape-Methode.
- Das Problem betrifft nur Werte, die als Text behandelt werden. Spalten, die als Zahl oder Boolean erkannt wurden, stehen ohnehin nicht in Anführungszeichen und sind nicht betroffen.
- Je mehr CSV-Zeilen es gibt, desto sicherer ist es, Werte mit Apostroph nicht von Hand zu suchen und zu korrigieren, sondern bei der Umwandlung automatisch escapen zu lassen. So geht nichts verloren.
Fügen Sie Ihr CSV ein und erhalten Sie sofort CREATE TABLE- und INSERT-Anweisungen, in denen einfache Anführungszeichen in den Werten automatisch escaped sind.
Häufig gestellte Fragen
Verschwindet das Problem, wenn ich Zeichenketten statt in einfache in doppelte Anführungszeichen setze?
Das hängt vom Dialekt ab. Manche Datenbanken erlauben doppelte Anführungszeichen für Zeichenketten. In Dialekten wie PostgreSQL oder SQL Server dienen sie jedoch nicht für Zeichenketten, sondern für Bezeichner wie Tabellen- und Spaltennamen. Der Wechsel zu doppelten Anführungszeichen löst das Problem daher nicht grundsätzlich und kann sogar andere Syntaxfehler verursachen. Am breitesten funktioniert über Dialekte hinweg, Zeichenkettenliterale in einfache Anführungszeichen zu setzen und darin zu escapen.
Darf ich statt der Verdopplung auch mit einem Backslash (') escapen?
Manche Datenbanken erkennen auch das Backslash-Escaping, aber es gehört nicht zum SQL-Standard, sondern ist eher eine Erweiterung einzelner Dialekte. Je nach Einstellung oder Dialekt wird der Backslash als normales Zeichen behandelt, sodass der Wert unter Umständen falsch gespeichert wird. Die Verdopplung des einfachen Anführungszeichens ist die standardkonforme Methode, die in vielen Dialekten gleichermaßen funktioniert.
Gibt es ohne Escaping immer einen sichtbaren Fehler?
Nicht unbedingt. Endet die Zeichenkette wegen eines einfachen Anführungszeichens früher als erwartet, passen die übrig gebliebenen Zeichen meist nicht zur Struktur der Anweisung und führen zu einem Syntaxfehler. Theoretisch kann es aber vorkommen, dass die Reste zufällig zum Rest der Anweisung passen. Dann läuft sie ohne Fehler durch, speichert aber einen anderen Wert als beabsichtigt. Welches Ergebnis konkret entsteht, hängt von der übrigen Struktur der Anweisung und von der Datenbank ab und lässt sich deshalb schwer verallgemeinern. Sicherer ist es, von vornherein zu escapen und diese Unsicherheit auszuschließen.
Muss ich bei Zahl- oder Boolean-Spalten auch auf das Escaping achten?
Nein. Das Setzen in einfache Anführungszeichen betrifft nur Zeichenkettenwerte (Text). Zahlen und Boolean-Werte stehen ohnehin ohne Anführungszeichen in der SQL-Anweisung. Da der Wert nicht in Anführungszeichen steht, kann auch kein Anführungszeichen die Zeichenkette unterbrechen. Auch dieses Tool schreibt Werte unverändert ohne Anführungszeichen, wenn es eine Spalte als Zahl oder Boolean erkennt. Nur als Text erkannte Spalten setzt es in Anführungszeichen und wendet das Escaping an.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen