Excel-zu-SQL-Konverter

Die Seite parst die hochgeladene Arbeitsmappe mit SheetJS – XLSX.read(arrayBuffer, {type: 'array'}) gibt ein Arbeitsmappenobjekt zurück, dessen Arbeitsblatt Zellen nach A1-Schlüsseln indexiert hat, dann wandelt XLSX.utils.sheet_to_json(sheet, {header: 1, defval: null}) den begrenzten !ref-Bereich in ein Array von Arrays um. Die erste nicht leere Zeile (wenn „Erste Zeile als Spaltenüberschriften“ aktiviert ist) wird als Spaltennamen verwendet; andernfalls werden SheetJS-artige col1, col2, col3 erzeugt. Jede verbleibende Zeile wird als einzelne SQL-Anweisung der Form INSERT INTO `table` (`c1`, `c2`, ...) VALUES (v1, v2, ...); ausgegeben, optional mit vorangestelltem CREATE TABLE `table` (`c1` VARCHAR(255), ...);. Bezeichner-Zitierung variiert je nach SQL-Dialekt und wird durch den SQL:1992-Standard und die jeweilige Abweichung des Herstellers bestimmt: Standard-SQL und PostgreSQL zitieren Bezeichner mit doppelten Anführungszeichen ("col"), MySQL und MariaDB verwenden standardmäßig Akutzeichen (`col`) und akzeptieren doppelte Anführungszeichen nur bei aktiviertem ANSI_QUOTES-SQL-Modus, SQLite akzeptiert sowohl Akutzeichen als auch doppelte Anführungszeichen (und behandelt aus Kompatibilitätsgründen doppelt zitierte Bezeichner, die nicht aufgelöst werden können, als Zeichenkettenliteral – eine bekannte Stolperfalle, die in der SQLite-Quirks-Seite dokumentiert ist), SQL Server und Sybase verwenden eckige Klammern ([col]). Wert-Zitierung folgt den SQL-Zeichenkettenliteral-Regeln: einfache Anführungszeichen umschließen das Literal und werden durch Verdopplung maskiert ('O''Brien'), gemäß ISO/IEC 9075. Leere Zellen werden zum unzitierten Literal NULL, nicht zur leeren Zeichenkette ''; numerische Zellen mit cell.t === 'n` werden unzitiert ausgegeben; Booleans werden zu 1/0 oder TRUE/FALSE je nach Dialekt; Daten erfordern besondere Behandlung. Datumszellen benötigen besondere Aufmerksamkeit, da SheetJS die zugrunde liegende numerische Seriennummer bewahrt: Excel speichert Daten als Tage seit 1900-01-01 mit dem historischen Schaltjahresbug von 1900-02-29, der Daten vor März 1900 um einen Tag verschiebt, und das Excel-für-Mac-1904-System verwendet 1904-01-01 als Epochenstart. Die Konvertierung zu ISO 8601 (YYYY-MM-DD HH:mm:ss, das Format, das sowohl MySQL DATETIME als auch PostgreSQL TIMESTAMP akzeptieren) ist (serial - 25569) * 86400000 ms nach der Unix-Epoche, dann in UTC formatiert. Typerkennung ist rein lexikalisch und oberflächlich: eine Spalte, deren erste nicht leere Zelle eine Ganzzahl ist, wird INT, Dezimalzahlen werden DECIMAL(10,2), Text wird VARCHAR(255), und eine Spalte, die mit 2024-01-01 beginnt, kann als Zeichenkette exportiert werden, es sei denn, die Quellzelle trägt cell.t === 'd'. Bulk-Inserts werden als ein INSERT pro Zeile ausgegeben, was in großem Maßstab langsam ist; das Zusammenfassen von 100-500 Zeilen in ein einzelnes INSERT INTO t VALUES (...), (...), ...; reduziert die Netzwerk-Rundläufe um ca. 100x, und das Einwickeln des Skripts in BEGIN; ... COMMIT; macht den Import zu einer atomaren Transaktion, die beim ersten fehlschlagenden Zeile zurückgerollt wird.

• Bezeichner-Zitierung je nach Dialekt: MySQL/MariaDB `col` (Akutzeichen, oder "col" mit ANSI_QUOTES aktiv); PostgreSQL und Standard-SQL "col"; SQL Server [col]; SQLite akzeptiert beide (aber "col" fällt stillschweigend auf ein Zeichenkettenliteral zurück, wenn col kein bekannter Bezeichner ist).
• Zeichenkettenliteral-Maskierung (ISO/IEC 9075): mit einfachen Anführungszeichen umschließen und interne einfache Anführungszeichen verdoppeln (O'Brien → 'O''Brien'); niemals rohe Backslashes inline verwenden – PostgreSQL standard_conforming_strings ist seit 9.1 standardmäßig aktiv.
• Excel-Datumsseriennummer: Tage seit 1900-01-01 mit dem 1900-02-29-Bug (oder 1904-01-01 wenn workbook.date1904 wahr ist); ISO 8601-Zeichenkette = new Date((serial - 25569) * 86400000).toISOString().
• Typerkennung ist lexikalisch: Ganzzahlen → INT, Dezimalzahlen → DECIMAL(10,2), Text → VARCHAR(255); Daten, die wie Daten aussehen, aber nicht als cell.t === 'd' typisiert sind, werden als Zeichenketten exportiert; Währungszellen mit Tausendertrennzeichen werden mit dem Trennzeichen innerhalb der Zeichenkette exportiert.
• NULL-Behandlung: eine leere Excel-Zelle wird zum unzitierten Literal NULL, nicht zu '' – der Unterschied ist wichtig für NOT NULL-Spalten und für COUNT(col), das NULLs überspringt, aber '' zählt.
• Bulk-Insert: 100-500 Zeilen in ein einzelnes INSERT INTO t VALUES (...),(...),...; zusammenzufassen reduziert Netzwerk-Rundläufe um ca. 100x gegenüber einem INSERT pro Zeile; MySQLs max_allowed_packet (Standard 64 MB) begrenzt die Größe pro Anweisung.
• Das erzeugte Skript in BEGIN;...COMMIT; (PostgreSQL/SQLite) oder START TRANSACTION;...COMMIT; (MySQL InnoDB) einwickeln, damit eine einzelne fehlschlagende Zeile den gesamten Batch zurückrollt; MyISAM-Tabellen ignorieren die Transaktion und committen teilweise.