---
title: "JSON- und NDJSON-Dateien mit SQL abfragen | DuckLocal"
description: "DuckDB-SQL auf JSON-, NDJSON- und JSON-Lines-Dateien ausführen, komprimiert oder nicht. Verschachtelte Objekte werden zu Spalten, die Sie filtern, entfalten und mit CSV und Parquet verknüpfen können – auf Ihrem eigenen Rechner."
image: https://ducklocal.app/og-image.jpg?v=2
language: de
---

# 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.

- .json .ndjson .jsonl
- Auch komprimiert als .json.gz
- Verschachtelte Felder als Spalten
- Übersicht für JSON Lines

## 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](https://ducklocal.app/docs/de/cli#jsonl-and-nested-json) · [DuckDBs JSON-Referenz](https://duckdb.org/docs/stable/data/json/overview)

```sql
-- 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](https://ducklocal.app/docs/de/data-sources#folders-and-patterns) · [CloudTrail-Logs lokal prüfen](https://ducklocal.app/docs/de/example-cloudtrail)

- 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](https://ducklocal.app/docs/de/data-sources#quick-look)

> **Lieber als Parquet behalten?** Exportieren Sie jedes Abfrageergebnis als Parquet: kleinere Dateien, typisierte Spalten und beim nächsten Lesen deutlich schneller. [Zum Parquet-Viewer →](https://ducklocal.app/de/use-cases/parquet-viewer/)

## 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](https://ducklocal.app/docs/de/cli) · [SQL für KI-Agenten](https://ducklocal.app/de/use-cases/ai-agent-sql/)

```bash
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.

Verwandt: [CSV mit SQL abfragen](https://ducklocal.app/de/use-cases/query-csv-with-sql/) · [Excel mit SQL abfragen](https://ducklocal.app/de/use-cases/query-excel-with-sql/) · [Parquet-Viewer](https://ducklocal.app/de/use-cases/parquet-viewer/) · [Lokale Datenanalyse](https://ducklocal.app/de/use-cases/local-data-analysis/)

## 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.

## Links

- [DuckLocal herunterladen](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Dem CloudTrail-Beispiel folgen](https://ducklocal.app/docs/de/example-cloudtrail)
- [Installieren und eine erste Abfrage ausführen](https://ducklocal.app/docs/de/getting-started)

Source: https://ducklocal.app/de/use-cases/query-json-with-sql/
