Von der JSON-Datei zum Ergebnis
Die Datei bleibt, wo sie ist. DuckDB liest sie bei jeder Abfrage an Ort und Stelle.
Datei hineinziehen
events.ndjsonwird zur Viewevents,logs.json.gzzur Viewlogs. DuckDB erkennt, ob die Datei ein Array, ein einzelnes Objekt oder ein Objekt pro Zeile ist.Die Struktur sehen
Die Schema-Seitenleiste zeigt verschachtelte Objekte als
STRUCT-Spalten und Arrays alsLIST-Spalten, mit ihren Feldern. Der Übersicht-Tab profiliert jede Spalte eines Ergebnisses.Wie eine Tabelle abfragen
Filtern Sie mit Punktnotation auf ein verschachteltes Feld, entfalten Sie Arrays mit
unnestund 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.
-- 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.
- 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.
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.
$ 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 wielogs.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 alsLIST-Spalten. Greifen Sie per Punktnotation darauf zu, entfalten Sie Listen mitunnestoder nutzen Siejson_extract_stringmit einem Pfad für unregelmäßige Daten. - Was, wenn die Datensätze in einem Array stecken, wie bei CloudTrail-Logs?
ducklocal schemabemerkt, 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.
Verwandt: CSV mit SQL abfragen · Excel mit SQL abfragen · Parquet-Viewer · Lokale Datenanalyse
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.