Перейти к содержимому
Invest Документация Invest

Импорт CSV

CSV-импорт — самый быстрый способ загрузить большой объём данных. Используется и для создания нового датасета из файла, и для добавления строк в существующий.

Лимиты

  • Размер файла: до 5 МБ.
  • Строк (без заголовка): до 10 000.
  • Колонок: до 50.

Если файл больше — разделите его перед загрузкой (например, по году или по типу записи).

Формат

  • Кодировка: UTF-8 (с BOM или без).
  • Разделитель: запятая или точка с запятой (определяется автоматически).
  • Перенос строки: \n или \r\n.
  • Заголовок: первая строка обязательна и должна содержать имена колонок.

Пример

Дата,Сумма,Категория,Комментарий
2026-04-15,15000,Аренда,Квартира на Ленина
2026-04-20,5000,Коммуналка,

Что происходит при импорте

  1. Файл загружается на сервер. Импорт выполняется в фоне как очередь — для больших файлов появляется индикатор прогресса.
  2. Система разбирает CSV, определяет тип каждой колонки по содержимому:
    • Число: если 80%+ значений похожи на число.
    • Дата: если 80%+ значений — ISO (YYYY-MM-DD) или русская (ДД.MM.ГГГГ).
    • Текст: всё остальное.
  3. Для нового датасета — создаются поля по колонкам CSV. Ключ полей — slugify имени колонки (Дата покупки → data_pokupki).
  4. Для существующего датасета — система предлагает сопоставление: какая колонка CSV в какое поле датасета попадает.

Сопоставление колонок (mapping)

Перед началом импорта в существующий датасет вы видите экран сопоставления:

  • Слева — список колонок CSV.
  • Справа — выпадающий список с полями датасета.
  • Имя колонки → ключ поля сопоставляются автоматически при совпадении.
  • Можно поправить вручную.
  • Можно пропустить колонку — она не загрузится.

Обработка ошибок

Если строка не прошла валидацию (например, обязательное поле пустое, тип не сходится):

  • Эта строка не загружается, но другие строки продолжают обрабатываться.
  • В отчёте по импорту видно: «успешно загружено N, пропущено M».
  • Для каждой пропущенной строки указана причина.

Идемпотентность

Импорт не идемпотентный — повторная загрузка того же файла создаст дубликаты строк. Если хотите «обновить», а не добавить — удалите существующие строки заранее или ведите импорт в отдельный датасет, а потом сравнивайте.

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

  • «Слишком большой файл». Лимит 5 МБ. Разбейте.
  • «Слишком много строк». Лимит 10 000. Разбейте по периодам.
  • Кодировка не UTF-8. Текст превращается в иероглифы. Сохраните файл в UTF-8 в Excel (Сохранить как → CSV UTF-8).
  • Дата в формате 5/3/26. Парсер ждёт YYYY-MM-DD или ДД.MM.ГГГГ. Двузначный год не примет.
  • Деньги без валюты. В CSV нет колонки «валюта» — система импортирует как число. Добавьте отдельную колонку с валютой или загрузите в новый датасет, где валюта проставится дефолтом.

Что дальше