Импорт CSV без потерь

Кодировка, идентификаторы и проверка результата.

6 минут чтения · Редакция от 3 ноября 2026

Подготовьте исходный файл

Сохраните исходную выгрузку отдельно и работайте с копией. Проверьте кодировку UTF-8 и разделитель: расширение CSV само по себе не означает, что колонки разделены запятой. В некоторых выгрузках используется точка с запятой.

external_id,name,source
lead-001,Анна,website
lead-002,Илья,partner

Значения с разделителями и переносами строк должны быть правильно заключены в кавычки. Не разбирайте такой файл простым разделением строк по запятой.

Сохраните смысл значений

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

Не путайте пустоту и ноль

Пустое поле, число 0 и строка «не указано» могут иметь разный смысл. Правило обработки нужно согласовать до загрузки.

Проверьте небольшой набор

Начните с нескольких строк, в которых встречаются длинные имена, кавычки, кириллица и пустые значения. Сравните результат с исходным файлом. Только после этого загружайте оставшуюся часть.

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

Сверьте итоги

Количество созданных, обновлённых, пропущенных и отклонённых записей должно объяснять каждую входную строку. Не удаляйте отчёт об ошибках до завершения сверки. Если импорт поддерживает откат, проверьте его на тестовом наборе заранее.