CSV-Dateien mit SQL abfragen

Ziehen Sie eine CSV-Datei auf DuckLocal, und sie wird zu einer Tabelle mit dem Namen der Datei. DuckDB ermittelt Trennzeichen, Kopfzeile und Spaltentypen, sodass Sie sofort SELECT, JOIN und GROUP BY nutzen können. Es gibt keinen Importschritt und kein CREATE TABLE, und auch Dateien, die für eine Tabellenkalkulation zu groß sind, sind nur eine Abfrage entfernt.

Kostenlos und Open Source für macOS, Windows und Linux. Kein Konto. Keine Telemetrie.

Von der CSV-Datei zum Ergebnis

Die Datei bleibt, wo sie ist. DuckLocal liest sie direkt.

  1. Die Datei hineinziehen

    sales.csv wird zu einer View namens sales. Tabulatorgetrennte .tsv-Dateien, .txt-Dateien und gzip-komprimierte .csv.gz-Dateien funktionieren genauso.

  2. SQL darauf schreiben

    Die Schema-Seitenleiste zeigt die Spalten und ihre abgeleiteten Typen, und die Autovervollständigung kennt sie. Nutzen Sie den vollen DuckDB-SQL-Dialekt: Joins, Fensterfunktionen, CTEs und PIVOT.

  3. Die Antwort behalten

    Stellen Sie das Ergebnis als Diagramm dar, sehen Sie sich die Verteilung jeder Spalte an oder exportieren Sie das vollständige Ergebnis nach CSV oder Parquet.

CSV-Dateien wie Tabellen joinen

Öffnen Sie orders.csv und customers.csv zusammen, und jede wird zu einer eigenen View. Joinen Sie sie in einer Anweisung, oder joinen Sie eine CSV-Datei mit einer Parquet-Datei, einem Excel-Sheet oder einer Tabelle in einer DuckDB-Datenbank.

Der SQL-Editor · Ergebnisse und Diagramme

SELECT c.region,
       count(*) AS orders,
       round(sum(o.amount), 2) AS revenue
FROM orders o
JOIN customers c USING (customer_id)
GROUP BY c.region
ORDER BY revenue DESC;

Viele Dateien, auch unordentliche

Lesen Sie einen ganzen Ordner mit CSV-Dateien als eine Tabelle mit read_csv. union_by_name toleriert Dateien, deren Spalten abweichen. Wenn ein einzelner Textwert die Typerkennung stört, lesen Sie alles als Text und casten Sie in der Abfrage.

Viele CSV-Dateien auf einmal lesen

SELECT try_cast(NULLIF(amount, 'NULL') AS DOUBLE) AS amount
FROM read_csv('data/*.csv',
              union_by_name = true,
              all_varchar = true);

Alles rund um die Abfrage

Ein Abfragefeld ist der Anfang. Diese Teile machen daraus einen Arbeitsbereich.

  • .csv .tsv .txtTrennzeichen, Kopfzeile und Typen von DuckDB erkannt
  • .csv.gzGzip-komprimierte Dateien öffnen sich ebenfalls als Daten
  • data/*.csvJede Datei öffnen, die einem Muster entspricht
  • folder/Jede Datendatei in einem Verzeichnis öffnen
  • ÜbersichtNULL-Werte, verschiedene Werte, Bereich und Verteilung pro Spalte
  • DiagrammeBalken-, Linien-, Streu-, Kreis- und Kartendiagramme aus einem Ergebnis
  • Parquet exportierenCSV-Daten nach Parquet konvertieren
  • ducklocal queryDieselbe SQL aus einem Terminal, mit JSON-Ausgabe

Ihre CSV verlässt Ihren Rechner nie

Online-CSV-Tools brauchen einen Upload. DuckLocal ist eine Desktop-App mit eingebettetem DuckDB: Es liest die Datei von ihrem Pfad, kopiert oder verändert sie nicht und braucht kein Konto.

Aggregationen laufen über jede Zeile der Datei. Das Raster zeigt bis zu 100.000 Zeilen eines Ergebnisses, und ein Export schreibt das vollständige Ergebnis.

  • Kein Upload und kein DuckLocal-Cloud-Dienst
  • Kein Datenbankserver zu installieren
  • Kein Konto und keine Telemetrie
  • Die Quelldatei wird nie verändert
  • Open Source unter Apache-2.0

CSV über die Kommandozeile abfragen

Dieselbe Binary läuft ohne Fenster: ducklocal query --sql "SELECT count(*) FROM 'sales.csv'" gibt das Ergebnis als JSON aus, für Skripte und KI-Agenten.

Fragen zu CSV und SQL

Muss ich eine CSV-Datei zuerst in eine Datenbank importieren?
Nein. DuckLocal legt eine View über die Datei, und DuckDB liest sie direkt. Die Datei wird nicht kopiert, konvertiert oder verändert, und das Entfernen der View lässt sie unberührt.
Kann ich mehrere CSV-Dateien in einer Abfrage joinen?
Ja. Jede Datei, die Sie öffnen, wird zu einer eigenen View, daher ist ein JOIN zwischen zwei CSV-Dateien gewöhnliches SQL. Sie können CSV auch mit Parquet, JSON, Excel-Sheets und DuckDB-Tabellen joinen.
Welchen SQL-Dialekt verwendet DuckLocal?
DuckDB SQL, das nahe an PostgreSQL liegt und analytische Funktionen wie Fensterfunktionen, PIVOT und das direkte Lesen von Dateien mit read_csv ergänzt.
Was, wenn der Typ einer Spalte falsch erkannt wird?
DuckDB leitet Typen aus einer Stichprobe der Datei ab. Wenn eine Spalte anders behandelt werden muss, lesen Sie sie mit read_csv(..., all_varchar = true) und konvertieren Sie sie in Ihrer Abfrage mit try_cast.
Kann ich eine CSV-Datei nach Parquet konvertieren?
Ja. Führen Sie SELECT * FROM auf der View aus und wählen Sie Parquet exportieren. Der Export führt die Abfrage erneut aus und schreibt jede Zeile.

SQL auf Ihrer eigenen CSV ausführen

Laden Sie DuckLocal herunter und folgen Sie dem Tutorial mit seiner Beispiel-CSV: von der Datei zum Diagramm in etwa zehn Minuten.