---
title: "Запросы к файлам JSON и NDJSON через SQL | DuckLocal"
description: "Выполняйте SQL DuckDB над файлами JSON, NDJSON и JSON Lines, сжатыми или нет. Вложенные объекты становятся столбцами, которые можно фильтровать, разворачивать и объединять с CSV и Parquet на своём компьютере."
image: https://ducklocal.app/og-image.jpg?v=2
language: ru
---

# Запросы к файлам JSON через SQL

Перетащите в DuckLocal файл JSON, NDJSON или сжатый лог, и он станет таблицей. Вложенные объекты превращаются в столбцы, которые можно фильтровать, разворачивать и объединять с CSV и Parquet. Не нужно писать конвейер на `jq` и поддерживать скрипты.

Бесплатно и с открытым исходным кодом для macOS, Windows и Linux. Файлы читаются на месте и никуда не загружаются.

- .json .ndjson .jsonl
- И сжатые .json.gz
- Вложенные поля как столбцы
- Быстрый просмотр для JSON Lines

## От файла JSON к результату

Файл остаётся на месте. DuckDB читает его там, где он лежит, при каждом запросе.

1. **Перетащите файл.** `events.ndjson` становится представлением `events`, а `logs.json.gz` — представлением `logs`. DuckDB сам определяет, что в файле: массив, один объект или по объекту на строку.
2. **Посмотрите на структуру.** Боковая панель схемы показывает вложенные объекты как столбцы `STRUCT`, а массивы — как столбцы `LIST`, вместе с их полями. Вкладка «Обзор» профилирует каждый столбец результата.
3. **Запрашивайте как таблицу.** Фильтруйте по вложенному полю через точку, разворачивайте массивы с помощью `unnest` и объединяйте результат с любым другим открытым файлом.

## Вложенные поля без шаблонного кода

Заказ с массивом позиций превращается в одну строку на заказ со списком `items`. `unnest` превращает этот список в строку на каждую позицию, а поля каждой позиции доступны через точку.

Для данных, форма которых меняется от записи к записи, `json_extract_string(col, '$.a.b[0].c')` проходит по пути и возвращает текст — есть там значение или нет.

[JSONL и вложенный JSON](https://ducklocal.app/docs/ru/cli#jsonl-and-nested-json) · [Справочник DuckDB по JSON](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;
```

## Логи, выгрузки и дампы API

Укажите DuckLocal папку или шаблон вроде `logs/2026-*/*.json.gz`, и каждое совпадение откроется как данные. Сжатые файлы распаковывать не нужно.

Некоторые инструменты оборачивают записи в один объект, как CloudTrail с его `{"Records": [...]}`. `ducklocal schema` замечает такую форму, и в подсказке даёт SQL, который читает записи как строки.

[Папки и шаблоны](https://ducklocal.app/docs/ru/data-sources#folders-and-patterns) · [Аудит логов CloudTrail локально](https://ducklocal.app/docs/ru/example-cloudtrail)

- Массивы JSON, одиночные объекты и JSON Lines
- Сжатые файлы читаются напрямую
- Папки и glob-шаблоны
- Объединение с данными CSV, Parquet и Excel
- Экспорт результатов в CSV или Parquet

## Просмотрщик NDJSON в Finder

На Mac выделите файл `.jsonl` или `.ndjson` и нажмите пробел. Превью DuckLocal в «Быстром просмотре» покажет столбцы и первые 50 строк таблицей, а не стеной текста. Превью ничего не записывает, никогда не читает файл целиком и ничего не скачивает.

[Превью в «Быстром просмотре»](https://ducklocal.app/docs/ru/data-sources#quick-look)

> **Хотите сохранить в Parquet?** Экспортируйте любой результат запроса в Parquet: файлы меньше, столбцы типизированы, а следующее чтение намного быстрее. [Посмотреть просмотрщик Parquet →](https://ducklocal.app/ru/use-cases/parquet-viewer/)

## JSON из командной строки

То же чтение работает и без интерфейса. `ducklocal schema` показывает столбцы файла JSON, включая вложенные, а `--stats` их профилирует. `ducklocal query` выполняет одну инструкцию и выводит типизированный JSON, так что ИИ-агент может запрашивать логи, не угадывая имена полей.

[Руководство по CLI](https://ducklocal.app/docs/ru/cli) · [SQL для ИИ-агентов](https://ducklocal.app/ru/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"
```

## Вопросы о JSON и SQL

**Какие форматы JSON открывает DuckLocal?** Документы JSON (`.json`), JSON с разделением по строкам (`.ndjson`, `.jsonl`) и их сжатые версии, например `logs.json.gz`. Каждый файл становится представлением с его именем.

**Как обрабатываются вложенные объекты?** DuckDB распознаёт вложенные объекты как столбцы `STRUCT`, а массивы — как столбцы `LIST`. Обращайтесь к ним через точку, разворачивайте списки с помощью `unnest` или используйте `json_extract_string` с путём для нерегулярных данных.

**А если записи обёрнуты в массив, как в логах CloudTrail?** `ducklocal schema` замечает, что файл — это один объект со списком записей внутри, и в подсказке даёт SQL, который читает записи как строки. Пример с CloudTrail в документации разбирает это по шагам.

**Есть ли просмотрщик NDJSON для Mac?** Да. Установив DuckLocal, выделите файл `.jsonl` или `.ndjson` в Finder и нажмите пробел: «Быстрый просмотр» покажет столбцы и первые 50 строк, не открывая приложение.

**Загружает ли DuckLocal мои файлы JSON куда-либо?** Нет. Файлы читает на месте DuckDB внутри приложения. Ничего не копируется на сервер, нет ни учётной записи, ни телеметрии.

Похожие страницы: [Запросы к CSV через SQL](https://ducklocal.app/ru/use-cases/query-csv-with-sql/) · [Запросы к Excel через SQL](https://ducklocal.app/ru/use-cases/query-excel-with-sql/) · [Просмотрщик Parquet](https://ducklocal.app/ru/use-cases/parquet-viewer/) · [Локальный анализ данных](https://ducklocal.app/ru/use-cases/local-data-analysis/)

## Выполните SQL над своим JSON

Скачайте DuckLocal, перетащите файл JSON или папку с логами и задайте первый вопрос.

## Ссылки

- [Скачать DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Пройти пример с CloudTrail](https://ducklocal.app/docs/ru/example-cloudtrail)
- [Установить и выполнить первый запрос](https://ducklocal.app/docs/ru/getting-started)

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