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

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

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

От файла 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 · Справочник DuckDB по JSON

-- 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, который читает записи как строки.

Папки и шаблоны · Аудит логов CloudTrail локально

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

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

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

Превью в «Быстром просмотре»

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

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

Руководство по CLI · SQL для ИИ-агентов

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"

Вопросы о 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 внутри приложения. Ничего не копируется на сервер, нет ни учётной записи, ни телеметрии.

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

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