Прочитать Excel | Load Excel

Нода позволяет осуществлять чтение Excel-файлов.

Подробнее о Denvic Visual Transformer (DVT)

Описание ноды

Нода читает один или несколько Excel-файлов и возвращает датафрейм.

Источник файла

Файл можно получить двумя способами:

  • Из подключённого хранилища. Соедините ноду с подключением к S3 или FTP/SFTP. В настройках выберите «Выбрать файл», затем нажмите «Обзор» в поле «Файл или маска поиска» либо введите путь вручную.

  • С компьютера. Используйте «Загрузить файл» в разделе «Источник файла». Файл сохраняется во внутреннем хранилище DVT, а его путь подставляется в ноду. Предварительно настраивать S3 или FTP для этого не требуется. Возможность доступна начиная с релиза 1.19.0.

Для чтения нескольких файлов укажите маску в поле «Файл или маска поиска». Маску вводите как обычный текст, без включения режима выражения. Пример приведён в разделе «Пример пакетной загрузки файлов» ниже.

Параметры подключения

В разделе «Параметры подключения» можно переопределить bucket, prefix или initial_directory, не создавая отдельного подключения. Это удобно, когда одно подключение используется с разными папками или бакетами. Раздел доступен начиная с релиза 1.18.1.

Начиная с релиза 1.19.5, для S3 доступно поле verify: оно позволяет включить или отключить проверку SSL-сертификатов для этой ноды, переопределив значение из подключения.

Параметры чтения

Источник файла и параметры чтения Load Excel

Поле

Как заполнить

Имя листа (sheet_name)

Укажите имя или индекс листа. Если поле пустое, читается первый лист.

Строка заголовка (header_row)

Укажите номер строки с названиями столбцов. Нумерация начинается с нуля: 0 — первая строка.

Столбцы (usecols)

Перечислите названия нужных столбцов через запятую. Пустое поле означает чтение всех столбцов.

Таймаут чтения (read_timeout_sec)

Укажите ограничение времени чтения в секундах. Пустое поле означает отсутствие ограничения. Настройка доступна начиная с релиза 1.19.0.

Числа, сохранённые как текст

Если числа в Excel сохранены как текст, задайте разделители, по которым нода будет распознавать их как числа:

  • Разделитель тысяч (thousands) — выберите разделитель, используемый в файле, или «Не использовать».

  • Десятичный разделитель (decimal) — выберите разделитель дробной части, используемый в файле. На скриншоте выбрана точка.

Типы столбцов

В разделе «Типы столбцов (dtype)» можно задать тип для отдельных колонок. Типы остальных колонок определяются автоматически.

  1. Нажмите «Добавить тип».

  2. Укажите название колонки из файла.

  3. Выберите тип в списке справа. На скриншоте показаны примеры Int64 и boolean.

  4. Повторите действия для остальных колонок, которым требуется явный тип. Чтобы удалить настройку, нажмите значок корзины справа от строки.

  5. Нажмите «Сохранить».

Разделители чисел и типы столбцов Load Excel

Согласно описанию релиза 1.22.0, если значение не соответствует выбранному типу, оно остаётся пустым, а чтение файла продолжается. После запуска проверьте результат преобразования в датафрейме.

Пример чтения файла из S3

Пошаговая инструкция "Как загрузить Excel в сценарий через S3 "

Для чтения файла из S3 соедините Load Excel с нодой подключения Get Existing S3 Connection.

Примечание:

Загрузка Excel-файла происходит из файлового менеджера, в него можно попасть, нажав кнопку «Мои файлы» в боковой панели.

Теперь необходимо настроить ноду — нажимаем в левом верхнем углу.

В открывшемся окне выберите «Выбрать файл» и нажмите «Обзор» в поле «Файл или маска поиска». Выберите предварительно загруженный Excel-файл. Затем задайте параметры чтения и, при необходимости, типы столбцов, как описано выше. Нажмите «Сохранить».

Проверка полученных данных

Теперь проверим, какие данные в итоге получились. Для этого включаем «Кэширование» в ноде (кликаем правой кнопкой мыши на ноду и активируем соответствующий переключатель), после чего нажимаем «Запустить с этой ноды». Затем снова открываем контекстное меню и выбираем «Показать датафреймы».

Наша таблица загрузилась.

Пример пакетной загрузки файлов

Пакетная загрузка Excel по маске

Пакетная загрузка файлов — это еще один вариант использования ноды Load Excel, загрузка файлов в таком случае производится по определенной маске. Как и ранее в примере, мы добавляем данную ноду и соединяем ее с нодой подключения к S3. Открываем настройки ноды Load Excel.

Предварительно мы загрузили в менеджер файлов два новых файла: «Учебная таблица Июль 2025» и «Учебная таблица Июнь 2025». Наша задача, чтобы все файлы, название которых начинается с «Учебная таблица» были загружены. Для этого в поле «Файл или маска поиска» пропишем маску:

s3://ERP/Test/Учебная таблица*.xlsx, где Учебная таблица — это совпадающая часть названия файлов, а * — различающаяся.

Все остальные поля оставляем без изменений.

Обратите внимание!

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

Проверим полученные данные так же, как делали это в предыдущем примере. В колонке «Дата продажи» видим, что сначала были загружены данные из файла за июль, а затем — из файла за июнь.