От файла JSON к результату
Файл остаётся на месте. DuckDB читает его там, где он лежит, при каждом запросе.
Перетащите файл
events.ndjsonстановится представлениемevents, аlogs.json.gz— представлениемlogs. DuckDB сам определяет, что в файле: массив, один объект или по объекту на строку.Посмотрите на структуру
Боковая панель схемы показывает вложенные объекты как столбцы
STRUCT, а массивы — как столбцыLIST, вместе с их полями. Вкладка «Обзор» профилирует каждый столбец результата.Запрашивайте как таблицу
Фильтруйте по вложенному полю через точку, разворачивайте массивы с помощью
unnestи объединяйте результат с любым другим открытым файлом.
Вложенные поля без шаблонного кода
Заказ с массивом позиций превращается в одну строку на заказ со списком items. unnest превращает этот список в строку на каждую позицию, а поля каждой позиции доступны через точку.
Для данных, форма которых меняется от записи к записи, json_extract_string(col, '$.a.b[0].c') проходит по пути и возвращает текст — есть там значение или нет.
-- 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, который читает записи как строки.
- Массивы JSON, одиночные объекты и JSON Lines
- Сжатые файлы читаются напрямую
- Папки и glob-шаблоны
- Объединение с данными CSV, Parquet и Excel
- Экспорт результатов в CSV или Parquet
Просмотрщик NDJSON в Finder
На Mac выделите файл .jsonl или .ndjson и нажмите пробел. Превью DuckLocal в «Быстром просмотре» покажет столбцы и первые 50 строк таблицей, а не стеной текста. Превью ничего не записывает, никогда не читает файл целиком и ничего не скачивает.
JSON из командной строки
То же чтение работает и без интерфейса. ducklocal schema показывает столбцы файла JSON, включая вложенные, а --stats их профилирует. ducklocal query выполняет одну инструкцию и выводит типизированный JSON, так что ИИ-агент может запрашивать логи, не угадывая имена полей.
$ 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 · Запросы к Excel через SQL · Просмотрщик Parquet · Локальный анализ данных
Выполните SQL над своим JSON
Скачайте DuckLocal, перетащите файл JSON или папку с логами и задайте первый вопрос.