NEQL↗TRAINING / 01 ↗

NEQL / ЖУРНАЛ

Бизнес / 2 минуты / 19 ноября 2026

JSONL-выгрузка перед импортом: три проверки на учебном файле

На трёх вымышленных товарных записях проверяем синтаксис, повторяющееся поле и сохранность идентификаторов. Пример можно скачать и повторить в инструменте NEQL.

Скачайте учебный TXT и откройте его как обычный текст. В нём три вымышленные товарные записи, подготовленные редакцией. Во второй намеренно оставлена лишняя запятая, в третьей дважды записано поле quantity. Скопируйте все три строки в инструмент JSON Lines и нажмите «Проверить строки».

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

В этой статье
Скачать учебный TXT с ошибкамиОткрыть проверку JSON Lines
Что получится при проверке учебного файла
ЭтапОжидаемый результат
Исходный TXTОшибка во второй строке; готовый результат ещё не сформирован.
Удалена лишняя запятаяТри записи; предупреждение об одном повторном вхождении имени поля.
Сверка идентификаторовВ результате сохранены строка sku «00042» и число id 9007199254740993.

Исправьте одну лишнюю запятую

Проверка выделит место ошибки во второй строке. Найдите её окончание: «"quantity":1,}». Уберите запятую между 1 и закрывающей фигурной скобкой, затем проверьте текст снова.

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

Разберитесь с повторным полем

После первой правки появится предупреждение: в третьей записи quantity встречается со значениями 1 и 3. Инструмент сохраняет оба поля. Предупреждение нужно разобрать до передачи настоящей выгрузки в принимающую систему.

RFC 8259 рекомендует уникальные имена внутри объекта и описывает различия в обработке повторов у приложений. Для реальных данных вернитесь к источнику и выясните, какое значение должно быть передано. Сам по себе правильный синтаксис этого не определяет.

Сверьте идентификаторы и схему импорта

В учебном результате сравните с исходником sku «00042» и id 9007199254740993. Скачиваемый JSONL сохраняет ведущие нули внутри строки и исходную запись длинного числа. Эти два примера помогают проверить разные типы идентификаторов.

Затем сверяйте требования принимающего приложения: строка или число ожидается в поле id, какие поля обязательны, какие значения quantity допустимы. Возможности числового типа у получателя могут отличаться. Подтвердите сохранность идентификаторов и значения полей в тестовом импорте своей системы.

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

Оригинал статьи: https://neql.org/blog/jsonl-export-check-before-import