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

Записать CSV

Записывает DataFrame в CSV-файл в файловом хранилище пространства (или подключённом). Перезаписывает целевой файл при существовании.

Записать CSV▶

ТаблицаИтог действия

Хранилище файловОшибка

Файл

Тип в графе: df_write_csv

Exec

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

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

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

Минимальный рабочий сценарий

Вход

Записать CSV▶

Выход▶

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

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

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

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

Сохраняет таблицу в CSV-файл хранилища. Соседняя нода Запись файла пишет текст и умеет заменять отдельные строки; здесь текст собирается за вас из таблицы — разделитель, кодировка, строка заголовка — и файл всегда переписывается целиком.

CSV выбирают, когда файл будут читать машиной или переливать в другую систему. Если файл откроет человек в Excel, посмотрите на Записать XLSX: там не возникает вопросов кодировки и разделителя.

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

Порт «Таблица» приносит и запуск, и данные: отдельного входа выполнения у ноды нет. Если момент записи должна задавать другая ветка, включите «Разделить входные порты» — появятся отдельные ноги для выполнения и для значения.

На вход годится не только таблица: список объектов (JSON-записи) и CSV-текст нода разберёт сама, поэтому конвертер перед записью нужен не всегда.

Путь — шаблон: reports/{{ variables.session_id }}.csv даёт по файлу на сессию. На выходе — path, bytes_written и rows_written (строки данных, без заголовка).

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

Ожидание дописывания. Режима «добавить в конец» нет: каждый запуск переписывает файл целиком. Историю делают путём с датой или идентификатором сессии.
Папки на WebDAV нет. В хранилище воркспейса недостающие папки создаются сами, на WebDAV — нет: запись в reports/2026/x.csv не пройдёт, пока каталога не существует.
Кириллица и эмодзи в cp1251. Символ, которого нет в кодировке, роняет шаг на кодировании, и повтор тут не помогает. Для файла, который будут открывать двойным кликом в Excel, берите «UTF-8 с BOM».
Пустая таблица. Пустой результат — не ошибка: получится файл с одним заголовком и rows_written: 0. Если пустой отчёт бессмысленен, проверяйте это выше по графу.

Входы

Порт	Провод	Данные	Примечания
Таблица`df`	Исполнение + данные`execute_data`	`dataframe`
Хранилище файлов`file_store`	Данные`data`	—	показывается, когда connection_source ≠ "auto"

Выходы

Порт	Провод	Данные	Примечания
Итог действия`output`	Исполнение + данные`execute_data`	`object`
Ошибка`on_error`	Исполнение + данные`execute_data`	—	показывается, когда expose_error_output = true
Файл`file`	Данные`data`	`file`

Настройки

Поле	Тип	По умолчанию	Описание
Путь к файлу`path`	`string`	`""`	Путь относительно корня хранилища. Шаблоны {{ }} подставляются на каждом запуске, поэтому ``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
Записывать заголовок`include_header`	`boolean`	`true`	Записывать имена столбцов первой строкой.
Источник подключения`connection_source`	`string`	`auto`	Откуда нода берёт подключение. «Из текущего запуска» использует то, что платформа уже знает (Telegram-бот, на который опубликован сценарий / собственное файловое хранилище этого пространства), и связей не требует. «Внешнее подключение» показывает ресурсный порт, чтобы в него можно было подключить конфиг-ноду. Варианты: `auto` — Из текущего запуска, `external` — Внешнее подключение (подключить конфиг-ноду)
Подпапка`store_subfolder`	`string`	`""`	Необязательная папка внутри стора этого пространства, которую считать корнем, напр. `reports` или `sessions/{{ variables.session_id }}`. Пусто = корень стора. поддерживает шаблоны показывается при «Источник подключения» = Из текущего запуска
Дополнительно
Макс. байт`max_bytes`	`integer`	`52428800`	Не записывать больше указанного числа байт.

Общие поля

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

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