От CSV до JSON: от электронной таблицы к структурированным

Строка заголовка становится вашими ключами

Первая строка содержит имена свойств JSON, а каждая следующая строка становится объектом. Это означает, что гигиена заголовков — это дизайн схемы: пробелы, повторяющиеся имена и знаки препинания в заголовках создают ключи, которые вы не можете удобно использовать. Перед преобразованием переименуйте в `snake_case` или `camelCase` и убедитесь, что нет двух столбцов с одинаковым именем — в большинстве реализаций повторяющийся заголовок автоматически перезаписывается.

Все, что находится в CSV, является строкой

CSV вообще не имеет типов, поэтому преобразователь решает, как интерпретировать каждый столбец. Числа становятся числами, поэтому вы можете заниматься арифметикой; `true`/`false` становятся логическими значениями; пустые поля становятся `null` или пустой строкой в ​​зависимости от вашего выбора. Ловушка — это идентификаторы: почтовые индексы, номера телефонов, номера счетов и строки версий, такие как `1.10`, должны оставаться строками, иначе вы потеряете ведущие нули и конечный смысл. Если столбец выглядит числовым, но является идентификатором, сохраните его как текст.

Кавычки, запятые и новые строки

В RFC 4180 это было решено несколько десятилетий назад: если поле содержит запятую, кавычку или разрыв строки, оно заключается в двойные кавычки, а внутренние кавычки удваиваются. Любой совместимый парсер (в комплект входит Papa Parse) обрабатывает обернутые поля со встроенными запятыми и многострочными ячейками, не задумываясь. Анализатор, который наивно разбивается по запятым, будет создавать столбцы, которые смещаются, как только одно поле адреса содержит запятую, что является классической ошибкой «почему мои данные смещены на единицу».

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

Откуда берутся файлы CSV (и что они несут)

Экспорт из аналитических инструментов, CRM-систем, биллинговых платформ и баз данных является наиболее распространенным источником и обычно содержит имена клиентов, адреса электронной почты и данные о доходах. Локальное преобразование полностью удаляет эти данные из сети. Преобразователь YamlBox CSV в JSON анализирует в браузере, позволяет выбрать разделитель и обработку типов и продолжает работать при отключенной сети.

Ожидания по размерам

Файл CSV содержит примерно один объект JSON на строку, поэтому преобразованный документ получается больше — ключи повторяются в каждой строке, а красивая печать добавляет отступ сверху. Для файла, достаточно большого, чтобы заставить ваш браузер приостановиться, преобразование массива объектов и последующая минификация дают наименьший практический результат, а преобразование в JSON строк (по одному объекту в строке, без массива) – правильная форма, если следующим потребителем является поток или конвейер журналов.