JSON-Dateien mit SQL abfragen

Ziehen Sie eine JSON-, NDJSON- oder komprimierte Logdatei in DuckLocal, und sie wird zur Tabelle. Verschachtelte Objekte werden zu Spalten, die Sie filtern, entfalten und mit CSV und Parquet verknüpfen können. Keine jq-Pipeline zu schreiben, kein Skript zu pflegen.

Kostenlos und Open Source für macOS, Windows und Linux. Dateien werden an Ort und Stelle gelesen und nie hochgeladen.

Von der JSON-Datei zum Ergebnis

Die Datei bleibt, wo sie ist. DuckDB liest sie bei jeder Abfrage an Ort und Stelle.

  1. Datei hineinziehen

    events.ndjson wird zur View events, logs.json.gz zur View logs. DuckDB erkennt, ob die Datei ein Array, ein einzelnes Objekt oder ein Objekt pro Zeile ist.

  2. Die Struktur sehen

    Die Schema-Seitenleiste zeigt verschachtelte Objekte als STRUCT-Spalten und Arrays als LIST-Spalten, mit ihren Feldern. Der Übersicht-Tab profiliert jede Spalte eines Ergebnisses.

  3. Wie eine Tabelle abfragen

    Filtern Sie mit Punktnotation auf ein verschachteltes Feld, entfalten Sie Arrays mit unnest und verknüpfen Sie das Ergebnis mit jeder anderen geöffneten Datei.

Verschachtelte Felder ohne Boilerplate

Eine Bestellung mit einem Array von Positionen wird zu einer Zeile pro Bestellung mit einer Liste items. unnest macht daraus eine Zeile pro Position, und die Felder jeder Position sind einen Punkt entfernt.

Für Daten, deren Form von Datensatz zu Datensatz wechselt, folgt json_extract_string(col, '$.a.b[0].c') einem Pfad und gibt Text zurück – ob dort etwas steht oder nicht.

JSONL und verschachteltes JSON · DuckDBs JSON-Referenz

-- orders.ndjson: one order per line,
-- each with an items array
WITH lines AS (
  SELECT order_id, unnest(items) AS item
  FROM orders
)
SELECT item.sku,
       sum(item.qty) AS units
FROM lines
GROUP BY item.sku
ORDER BY units DESC;

Logs, Exporte und API-Dumps

Zeigen Sie DuckLocal einen Ordner oder ein Muster wie logs/2026-*/*.json.gz, und jeder Treffer wird als Daten geöffnet. Komprimierte Dateien müssen nicht entpackt werden.

Manche Werkzeuge verpacken ihre Datensätze in ein einziges Objekt, etwa CloudTrails {"Records": [...]}. ducklocal schema erkennt diese Form, und sein Hinweis liefert das SQL, das die Datensätze als Zeilen liest.

Ordner und Muster · CloudTrail-Logs lokal prüfen

  • JSON-Arrays, Einzelobjekte und JSON Lines
  • Komprimierte Dateien direkt gelesen
  • Ordner und Glob-Muster
  • Joins mit CSV-, Parquet- und Excel-Daten
  • Ergebnisse als CSV oder Parquet exportiert

Ein NDJSON-Viewer im Finder

Wählen Sie auf dem Mac eine .jsonl- oder .ndjson-Datei aus und drücken Sie die Leertaste. DuckLocals Übersicht-Vorschau (Quick Look) zeigt ihre Spalten und die ersten 50 Zeilen als Tabelle statt als Textwand. Die Vorschau schreibt nie, liest nie die ganze Datei und lädt nichts herunter.

Übersicht-Vorschauen

JSON auf der Kommandozeile

Dasselbe Lesen funktioniert ohne Oberfläche. ducklocal schema zeigt die Spalten einer JSON-Datei, auch verschachtelte, und --stats profiliert sie. ducklocal query führt eine Anweisung aus und gibt typisiertes JSON aus, sodass ein KI-Agent Logs abfragen kann, ohne Feldnamen zu raten.

CLI-Leitfaden lesen · SQL für KI-Agenten

Terminal
$ ducklocal schema events.jsonl
$ ducklocal query --sql \
  "SELECT json_extract_string(event,
            '$.payload.items[0].sku') AS sku,
          count(*) AS n
   FROM read_ndjson_objects('events.jsonl')
   GROUP BY 1 ORDER BY n DESC"

Fragen zu JSON und SQL

Welche JSON-Formate öffnet DuckLocal?
JSON-Dokumente (.json), zeilengetrenntes JSON (.ndjson, .jsonl) und komprimierte Varianten davon wie logs.json.gz. Jede Datei wird zu einer View mit ihrem Namen.
Wie werden verschachtelte Objekte behandelt?
DuckDB erkennt verschachtelte Objekte als STRUCT-Spalten und Arrays als LIST-Spalten. Greifen Sie per Punktnotation darauf zu, entfalten Sie Listen mit unnest oder nutzen Sie json_extract_string mit einem Pfad für unregelmäßige Daten.
Was, wenn die Datensätze in einem Array stecken, wie bei CloudTrail-Logs?
ducklocal schema bemerkt, dass eine Datei ein Objekt ist, das eine Liste von Datensätzen umschließt, und sein Hinweis liefert das SQL, das die Datensätze als Zeilen liest. Das CloudTrail-Beispiel in der Dokumentation geht das Schritt für Schritt durch.
Gibt es einen NDJSON-Viewer für den Mac?
Ja. Wenn DuckLocal installiert ist, wählen Sie im Finder eine .jsonl- oder .ndjson-Datei aus und drücken die Leertaste: Die Übersicht zeigt ihre Spalten und die ersten 50 Zeilen, ohne die App zu öffnen.
Lädt DuckLocal meine JSON-Dateien hoch?
Nein. Die Dateien werden von DuckDB in der App an Ort und Stelle gelesen. Nichts wird auf einen Server kopiert, und es gibt weder Konto noch Telemetrie.

SQL auf Ihr eigenes JSON

Laden Sie DuckLocal herunter, ziehen Sie eine JSON-Datei oder einen Ordner voller Logs hinein und stellen Sie Ihre erste Frage.