Все ноды/Data/DataFrame I/O

Читать CSV

Считывает CSV-файл из подключённого file_store (WebDAV) и преобразует его в DataFrame. Параметры: разделитель, кодировка, строка заголовка.

Читать CSV▶

File storeSuccess

Error

Тип в графе: df_read_csv

Exec

Можно включить ветку ошибки (expose_error_output) и обработать сбой отдельным путём.

Порты можно разделить на исполнение и данные (split ports).

Как попробовать

Минимальный рабочий воркфлоу

Вход

Читать CSV▶

Выход▶

Исполнение
Исполнение + данные

Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Запускается сразу

Как применять

Забирает CSV-файл из файлового хранилища и превращает его в таблицу (DataFrame) — то, с чем дальше работают ноды семейства DF: фильтр строк, выбор столбцов, группировка.

Соседняя нода Чтение файла отдаёт тот же файл просто текстом. Берите её, когда содержимое нужно как строка (в промпт, в шаблон, в лог), и эту — когда следующим шагом идут фильтрация, соединение или агрегация по столбцам.

Как это работает

«Источник подключения» по умолчанию стоит в «Из контекста рана»: нода читает собственное хранилище воркспейса — то же дерево, которое показывает раздел «Файлы». Поле «Подпапка» сужает корень. Если файл лежит во внешнем WebDAV, переключите на «Внешнее подключение» и подайте в появившийся порт «File store» ноду WebDAV-конфигурация или Хранилище workspace.

«Путь к файлу» — шаблон, он рендерится на каждом запуске, поэтому reports/{{ variables.session_id }}.csv читает свой файл под каждую сессию.

Дальше по графу уезжает вся таблица целиком, а в логе запуска и в карточке ноды видно только превью: первые 50 строк, размер (строки × столбцы) и типы столбцов.

Частые ошибки

Таблицу подставили в текст. {{ nodes.<id>.output }} в промпте или шаблоне даст DataFrameEnvelope(rows=120, cols=5), а не данные. Чтобы получить текст, поставьте Конвертер в CSV или JSON.
Выгрузка из Excel с точкой с запятой. Разделитель по умолчанию ,; для такого файла поставьте ;, иначе строка станет одним столбцом с длинным именем. Старые кириллические выгрузки вдобавок часто идут в Windows-1251.
«Индекс строки заголовка» = -1. Заголовок не читается, столбцы получают имена 0, 1, 2, и все дальнейшие обращения по имени столбца перестают совпадать.
Файл больше лимита. «Макс. байт» (по умолчанию 25 МиБ) — это не отказ, а обрезка: придёт неполная таблица, признак — meta.truncated в превью. «Лимит строк» ограничивает уже разобранные строки и байты не экономит.
Файла ещё нет. Шаг падает с ошибкой «файл не найден». Если «файла может не быть» — штатный случай, включите «Выход ошибки» и уведите эту ветку отдельно.

Входы

Порт	Провод	Данные	Примечания
File store`file_store`	Данные`data`	—	показывается, когда connection_source ≠ "auto"

Выходы

Порт	Провод	Данные	Примечания
Success`output`	Исполнение + данные`execute_data`	`dataframe`
Error`on_error`	Исполнение + данные`execute_data`	—	показывается, когда expose_error_output = true

Настройки

Поле	Тип	По умолчанию	Описание
Путь к файлу`path`	`string`	`""`	Путь относительно корня хранилища. Jinja-шаблоны рендерятся на каждом ране, поэтому ``reports/{{ variables.session_id }}.csv`` пишет отдельный файл на каждую сессию. поддерживает шаблоны
Разделитель`delimiter`	`string`	`,`	Разделитель столбцов, обычно ``,`` или ``;``.
Кодировка текста`encoding`	`string`	`utf-8`	Кодировка символов файла. Используйте utf-8-sig, если CSV должен корректно открываться в Excel, и cp1251 для устаревших кириллических выгрузок. Варианты: `utf-8` — UTF-8, `utf-8-sig` — UTF-8 с BOM (Excel), `utf-16` — UTF-16, `cp1251` — Windows-1251 (кириллица), `cp1252` — Windows-1252 (западноевропейская), `latin-1` — Latin-1 (ISO 8859-1), `koi8-r` — KOI8-R, `ascii` — ASCII
Индекс строки заголовка`header_row`	`integer`	`0`	Индекс строки заголовка столбцов (с 0). Используйте -1, чтобы пропустить заголовок.
Источник подключения`connection_source`	`string`	`auto`	Откуда нода берёт подключение. «Из контекста рана» использует то, что платформа уже знает (Telegram-бот, в который задеплоен этот воркфлоу / собственное файловое хранилище этого воркспейса), и не требует проводов. «Внешнее подключение» показывает ресурсный порт, чтобы в него можно было подключить конфиг-ноду. Варианты: `auto` — Из контекста рана, `external` — Внешнее подключение (подключить конфиг-ноду)
Подпапка`store_subfolder`	`string`	`""`	Необязательная папка внутри стора этого воркспейса, которую считать корнем, напр. `reports` или `sessions/{{ variables.session_id }}`. Пусто = корень стора. поддерживает шаблоны показывается при connection_source = auto
Дополнительно
Лимит строк`nrows_limit`	`integer`	`0`	Максимум строк для чтения (0 = без лимита).
Макс. байт`max_bytes`	`integer`	`26214400`	Не передавать больше указанного числа байт.

Общие поля

Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.

expose_error_output — Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этого шага.
split_ports_in — Показывать отдельные порты входа для выполнения и данных вместо одного объединённого.
split_ports_out — Показывать отдельные порты выхода для выполнения и данных вместо одного объединённого.