Поиск
Введите не менее двух символов без личных данных.

    БиблиотекаСтатьи и часто задаваемые вопросы Ваш проектЗапросить цитату
    ЯзыкRU ▾
    Практические руководства

    Подготовка надежного импорта и экспорта данных

    Открываемый файл не обязательно используется. Надежный обмен сохраняет значения полей, отличает неизвестные значения от нуля и сопоставляет записи без обработки метки дисплея как хрупкого идентификатора.

    См. метод

    Иллюстрация — Подготовка надежного импорта и экспорта данных
    Иллюстрация, созданная ИИ

    Опишите контракт данных

    Напишите полевой словарь, охватывающий значение, тип, единицу измерения, требуемый статус и отсутствующие значения. Определите стабильные идентификаторы и отношения. Почтовый индекс, номер продукта или административный код могут потребовать текстовое представление для сохранения его значения.

    Укажите кодирование, разделитель, даты, часовые пояса и десятичные соглашения. Документация CSV Python объясняет конфигурацию диалекта; Само по себе расширение файла не навязывает идентичные соглашения каждому производителю.

    Опишите диалект CSV до подсчета строк. В формате RFC 4180 поля с запятой, кавычкой или переносом заключаются в двойные кавычки, внутренние удваиваются. [CRLF] обозначает реальную пару возврата каретки и перевода строки в тесте. Поле остается частью одной логической записи.

    Тест: заголовок и две записи с CRLF в поле второй занимают четыре физические строки, не четыре записи. Используйте CSV-анализатор и сравните поля. Стандартный читатель Python дает строки: 00120 сохраняет нули до дальнейшего преобразования. Пустоты и открытие таблицей определяйте отдельно; кавычки CSV не обезвреживают формулы.

    Прокрутите таблицу по горизонтали, чтобы прочитать все столбцы. При работе с клавиатурой переведите фокус на таблицу и используйте клавиши со стрелками.

    CSV с запятыми: четыре фрагмента; [CRLF] — реальный перенос
    Учебный фрагментЧисло полейПрочитанные поля как текст
    "Paris, France"1["Paris, France"]
    "A ""B"""1["A \"B\""]
    "A[CRLF]B"1["A[CRLF]B"]
    00120,2["00120", ""]

    Постройте партию, которая бросает вызов границам

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

    Решите, отклоняет ли проблема одну строку, отклоняет файл или производит импорт с отчетом о проблеме. Избегайте сообщения об успехах, бесшумно удаляя поля. Отчет принят, отклонил и проверял строки.

    Разрешения на обмен планами и безопасность

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

    Отделяйте авторизованные данные из внутреннего контекста, которые не должны распространяться, например, личные комментарии, ненужные контактные данные или технические ключи. Используйте очищенные или синтетические тестовые копии. Хранение документов, хранение и удаление временного экспорта.

    согласовать данные после обработки

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

    Ведите резервную копию и записывайте перед деструктивным импортом. Различать обновления, дополнения и удаление. Отсутствующая строка в частичном экспорте не означает, что она должна быть удалена автоматически. Согласитесь с этими правилами перед обработкой полной базы данных.

    Первичная документация: Python : чтение и запись CSV-файлов.

    Вымышленный пакет: шесть записей последовательно имеют текстовые идентификаторы 00120, 00121, 00120, 00122, 00123 и 00124. До импорта 00121 существует со значением для изменения, а 00122 уже совпадает. Выбранное правило принимает первое вхождение ключа, отклоняет повтор в пакете и отклоняет 00123 из-за отсутствующей обязательной связи. Первый проход даёт 2 созданные + 1 обновлённую + 1 неизменённую + 2 отклонённые = 6 проверенных записей.

    После прохода в целевой базе четыре идентификатора: 00120, 00121, 00122 и 00124. Точное повторение пакета с теми же правилами и без промежуточных изменений должно дать 0 созданных, 0 обновлённых, 4 неизменённых и 2 отклонённых записи. Это следует из контракта импорта, а не автоматически из CSV. Сохраняйте начальные нули и считайте логические записи парсера: поле в кавычках может содержать перевод строки.

    Прокрутите таблицу по горизонтали, чтобы прочитать все столбцы. При работе с клавиатурой переведите фокус на таблицу и используйте клавиши со стрелками.

    Итог первого вымышленного импорта шести записей
    РезультатКоличествоЗатронутые записи
    Созданы200120 и 00124
    Обновлена100121: значение отличается от целевого
    Без изменений100122: значение уже совпадает
    Отклонены2Вхождение 3: повтор 00120; вхождение 5: отсутствует связь для 00123

    Выдавать экспорты с читаемыми именами на опубликованных языках.

    Вымышленный случай: имя экспорта содержит кириллицу. Проверьте filename, filename*, тип и сохранённый файл. Очистите имена из пользовательского ввода до формирования заголовков. Заголовок не защищает доступ и не заменяет проверку полномочий.

    • Имя читаемо, тип верен и ввод не может добавить новый заголовок.
    • MDN Content-Disposition

      Справочник отображения или скачивания с параметрами имени файла.

    Сравнить экспорт и обратный импорт

    Накопитель и USB-кабель между двумя ноутбуками
    Иллюстрация, созданная ИИ · Сравните поля после экспорта и обратного импорта.

    Предлагаемый пример: экспорт и импорт меняют начальные нули и даты, хотя число строк сохраняется.

    Используйте вымышленные данные с разными буквами, пустыми значениями и форматами. Сравните поля отдельно и запишите допустимые и ошибочные преобразования.

    • Подготовить разные случаи
    • Сравнить импортированные поля
    • Записать преобразования

    Справочные документы

    Содержание обновлено

    Документированные ориентиры по теме

    Документированные ориентиры по теме
    ИсточникЗначение или синтаксисОбласть применения
    RFC 4180 · CSV
    text/csv · "a,b"Поля с запятыми, кавычками или переносами заключаются в кавычки; внутренние кавычки удваиваются.
    RFC 8259 · JSON
    application/json · UTF-8Стандартный JSON не допускает комментариев и завершающей запятой; строки заключаются в двойные кавычки.
    RFC 3339 · Date-time
    2026-10-22T09:00:00+02:00Явное смещение связывает местное время с UTC; пример не обозначает запись на прием.

    Даты обозначают обращение к источникам. Эти сведения не являются аудитом сайта или общим заявлением о соответствии.

    Матрица функциональной проверки для адаптации к проекту

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

    Прокрутите таблицу по горизонтали, чтобы прочитать все столбцы. При работе с клавиатурой переведите фокус на таблицу и используйте клавиши со стрелками.

    Тестовые случаи, ожидаемые результаты и полезные доказательства
    КейсОжидаемый результатДоказательство для сохранения
    Акценты, разделители и многострочный текстЗначения сохраняют свое значение после экспорта и повторного импорта.Поле-поля сравнения с использованием небольшого репрезентативного справочного файла с известными значениями.
    ноль, пустой, нулевой и отсутствующийЧетыре штата следуют определенным правилам, где это требуется по контракту.Словарь данных и значения, фактически полученные пунктом назначения.
    Повторный идентификаторВыбранное правило различает дублирование, обновления и законные варианты.Принято и отказано в журнале строк, с причинами для каждого решения.
    Неудача на полпутиКоманда знает, какие изменения были применены и как возобновить.Окончательное состояние, затронутые строки и процедура восстановления, выполненная с использованием синтетических данных.

    Часто задаваемые вопросы

    Зачем держать некоторые коды в виде текста?

    Они идентифицируют сущность, а не количество. Автоматическое преобразование может потерять ведущие нули или изменить презентацию. Определите тип в контракте и проверьте пример границы.

    Доказывает ли неизмененное количество строк правильное значение?

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