Материал обновлён 21 октября 2026 года.
Поставщик прислал CSV с остатками, сотрудник загрузил его в систему и увидел сообщение об успехе. Позже обнаружилось, что артикулы потеряли ведущие нули, а десятичные значения прочитались неверно. Импорт полезно проектировать как несколько наблюдаемых этапов, чтобы ошибку в структуре файла замечали до изменения рабочих записей.
Согласуйте формат и смысл полей
В учебной системе учёта файл содержит артикул, название и остаток. До настройки импорта согласуйте смысл каждого поля.
| Поле | Правило |
|---|---|
| Артикул | Текстовый тип: значение с ведущими нулями может быть самостоятельным идентификатором |
| Название | Текст товара в согласованном столбце |
| Остаток | Определённая единица и согласованная допустимость дробей |
Название столбца "Количество" недостаточно, если одна сторона считает штуки, а другая упаковки.
Зафиксируйте кодировку, разделитель, наличие строки заголовков и правила записи пустых значений. Документация PostgreSQL для команды COPY отдельно описывает эти параметры, кавычки и обработку CSV. Файлы из разных программ могут требовать разных настроек. Внешнее сходство таблиц после открытия в редакторе не подтверждает одинаковый формат обмена.
Попросите небольшой согласованный пример файла и включите в учебные записи:
- Русское название.
- Запятую внутри текста.
- Кавычку.
- Пустое необязательное поле.
Проверьте пример обычным текстовым просмотром вместе с табличным представлением. Эти записи помогают проверить правила разбора; реальные персональные сведения для этого обычно не требуются.
Покажите предварительное соответствие столбцов
После загрузки файла система может предложить сопоставление: какой столбец станет артикулом, названием и остатком. Покажите несколько разобранных записей и применённые правила преобразования. Сотрудник должен заметить, если все данные попали в одну колонку или название было принято за первую товарную запись.
Различайте номер физической строки файла и номер разобранной записи, когда поля содержат переносы строк. В документации PostgreSQL отмечается, что CSV допускает такие поля в кавычках. Сообщение об ошибке должно позволять найти проблемное место с учётом выбранного способа разбора, особенно в файле с длинными описаниями.
Проверьте данные до фиксации
Составьте правила обязательности, типов и допустимых значений. Отдельно решите, как искать существующую запись и что делать с повторяющимися артикулами внутри файла. Эти вопросы относятся к смыслу рабочей системы. Успешный разбор CSV подтверждает получение значений, но ещё требует проверки их пригодности для изменения каталога.
В учебном сценарии до записи показываются обнаруженные товары, неизвестные артикулы и некорректные остатки. Сообщение "В записи 7 отсутствует артикул" помогает исправить источник. Общая надпись "Ошибка импорта" оставляет сотрудника без понятного действия. Не помещайте лишние чувствительные данные в технический журнал ради объяснения одной проблемы.
Выберите правило частичного результата
Согласуйте, должен ли весь файл отклоняться при ошибке или допускается сохранение пригодных записей. Выбор зависит от процесса. Связанный набор цен может требовать согласованного обновления целиком, тогда как независимые справочные записи иногда допускают частичную обработку. Это решение следует принять явно и отразить в интерфейсе.
В документации актуальной PostgreSQL предусмотрены параметры поведения при отдельных ошибках преобразования. Их возможности и ограничения относятся к конкретной версии и команде. Пользовательский импорт дополнительно должен учитывать бизнес-проверки, связанные записи и границу фиксации. Одного переключателя базы данных для полного сценария недостаточно.
После завершения покажите фактическое число сохранённых и отклонённых записей и доступный отчёт по ошибкам. Сохраните связь результата с исходным файлом и настройками загрузки. При повторной обработке исправленного файла сотрудник должен понимать, какие данные уже изменены и как избежать нежелательной замены действующих сведений.
Разработку импорта CSV и автоматизацию обмена данными можно обсудить с Семёном Дулесовым.
Какая ошибка входного файла сейчас обнаруживается у вас только после изменения рабочих данных?