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

Откройте книгу в DuckLocal, и каждый лист станет таблицей. Объединяйте листы между собой, с файлами CSV и Parquet или с базой данных DuckDB и получайте ответы, которые не даст сводная таблица. Без установки Excel, без сервера баз данных, без загрузки данных куда-либо.

Бесплатно и с открытым исходным кодом для macOS, Windows и Linux. Книга только читается и никогда не изменяется.

От книги к ответу

Перетащите файл в окно или откройте его через меню. Никакого мастера импорта, по которому нужно прокликиваться.

  1. Откройте книгу

    Первый лист становится таблицей с именем файла: budget.xlsx даёт budget. Остальные листы получают имена вида {file}_{sheet}, например budget_actuals. Пустые листы пропускаются.

  2. Пишите SQL по листам

    Боковая панель схемы показывает столбцы каждого листа и определённые типы, а автодополнение их знает. Доступны соединения, оконные функции, PIVOT и весь остальной SQL DuckDB.

  3. Сохраните результат

    Постройте по нему график, посмотрите распределение каждого столбца или экспортируйте полный результат в CSV для электронной таблицы или в Parquet для других инструментов.

Объединяйте листы, книги и файлы

Поиск между листами, для которого понадобились бы формулы VLOOKUP (ВПР), в SQL — один JOIN. Так же это работает между двумя книгами или между листом и CSV-выгрузкой из другой системы.

Редактор SQL · Запросы к CSV через SQL

-- budget.xlsx: first sheet → budget,
-- sheet "actuals" → budget_actuals
SELECT b.department,
       b.planned,
       sum(a.amount)             AS spent,
       b.planned - sum(a.amount) AS remaining
FROM budget b
JOIN budget_actuals a USING (department)
GROUP BY b.department, b.planned
ORDER BY remaining;

Как лист становится таблицей

Первая строка — заголовок. Каждый столбец получает самый узкий тип, в который помещаются все его ячейки: целые числа становятся BIGINT, смесь целых и дробных — DOUBLE, даты — TIMESTAMP, значения «истина/ложь» — BOOLEAN. Любая другая смесь остаётся VARCHAR, так что ничего не теряется, а в SQL можно применить TRY_CAST.

Подробнее об импорте книг

  • Пустые ячейки становятся NULL
  • Пустой заголовок становится column_1, column_2…
  • Повторяющийся заголовок получает суффикс: amount, amount_2
  • Формулы приходят в виде значений
  • В файл книги ничего не записывается

Копия, которую можно сохранить

В отличие от CSV и Parquet, которые DuckLocal читает на месте, лист копируется в таблицу при открытии книги. Если вы изменили файл в Excel, откройте его снова — таблицы будут заменены.

Чтобы сохранить таблицы, сначала откройте базу данных .duckdb, а затем книгу. Листы сохранятся в этой базе, будут на месте при следующем открытии и доступны любому клиенту DuckDB.

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

ducklocal schema показывает книгу и её листы, а --stats профилирует первый лист: пропуски, число различных значений, диапазоны и медианы по столбцам. ИИ-агент видит, что лежит в таблице, ещё до того, как напишет SQL.

Чтобы обращаться к листам из скрипта или агента, сохраните их в базу данных в приложении, как описано выше, а затем выполните ducklocal query --database для этого файла.

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

Terminal
$ ducklocal schema budget.xlsx
$ ducklocal schema budget.xlsx --stats
$ ducklocal query --database budget.duckdb \
  --sql "SELECT department, sum(amount)
         FROM budget_actuals
         GROUP BY department"

Вопросы об Excel и SQL

Какие форматы электронных таблиц поддерживает DuckLocal?
Книги Excel .xlsx, .xls и .xlsb, а также таблицы OpenDocument .ods. Каждый непустой лист импортируется как отдельная таблица.
Изменяет ли DuckLocal мою книгу?
Нет. Он читает файл и копирует каждый лист в таблицу; в саму книгу ничего не записывается. Если потом вы отредактируете её в Excel, откройте её снова, чтобы подхватить изменения.
Переносятся ли формулы?
Переносятся их значения. DuckLocal читает результаты, которые программа электронных таблиц сохранила в файле, а не сами формулы, поэтому столбец итогов приходит в виде чисел.
Можно ли выгрузить результат обратно в электронную таблицу?
Любой результат можно экспортировать в CSV, который откроет Excel и любая другая программа электронных таблиц, или в Parquet для других инструментов. Файлы .xlsx DuckLocal не записывает.
Может ли DuckLocal заменить Excel?
Для анализа — да: соединения между листами и файлами, агрегаты и данные, которые не помещаются в лимит листа в 1 048 576 строк. Но это не редактор таблиц: в ячейки ничего не вводят и формул не пишут.

Выполните SQL над своей книгой

Скачайте DuckLocal, перетащите таблицу и объедините её листы одним запросом.