Data Studio

Одне дерево, шість форматів

Кожна конвертація розбирає джерело в єдине типізоване дерево, а потім записує це дерево у цільовому форматі. Саме тому перетворення туди й назад чесні: число залишається числом, вкладеність зберігається, а ключі об’єктів лишаються в тому порядку, в якому їх написали, замість тихого сортування за абеткою. І саме тому додати формат — це один парсер і один серіалізатор, а не новий особливий випадок для кожної пари.

На що здатен кожен формат

JSON

Стандартний формат обміну. Зберігає вкладеність і типи.

YAML

Зручний для конфігурацій і коментарів, хоча коментарі не переносяться.

TOML

Потребує таблиці в корені. Значення null відкидаються — у TOML їх немає.

CSV

Готовий для таблиць. Потребує масиву об’єктів; вкладені значення стають комірками з JSON.

TSV

CSV із табуляціями. Безпечніший, коли у ваших даних багато ком.

JSONL

Один документ на рядок. Формат, який використовують конвеєри логів і набори даних для LLM.

Незручні випадки, оброблені свідомо

• У CSV немає типів. Комірка стає числом лише тоді, коли виведення цього числа точно відтворює початковий текст, тож 007 залишається рядком, а 12 — ні.
• У CSV немає вкладеності. Під час запису таблиці з вкладених даних вкладені значення зберігаються як JSON усередині комірки замість вигаданої схеми сплющення, яку вам потім довелося б розгортати назад.
• У TOML немає null. Ключі зі значенням null відкидаються замість того, щоб зламати весь документ, а джерело, у корені якого не об’єкт, відхиляється одразу — TOML потребує там таблиці.
• Коментарі — не дані. Коментарі YAML і TOML живуть поза деревом, тож конвертацію вони не переживають. Ніщо не може перенести їх на інший бік.

Поширені запитання

Як конвертувати JSON у YAML або YAML у JSON?

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

Чи зберігаються початкові нулі під час конвертації CSV у JSON?

Так. Комірка перетворюється на число лише тоді, коли зворотне виведення цього числа точно відтворює початковий текст, тож ідентифікатор на кшталт 007 залишається рядком «007», а 12 стає числом 12.

Чи зберігається порядок ключів у моєму JSON?

Так. Ключі об’єктів зберігають порядок документа замість сортування за абеткою, тож результат можна й далі порівнювати з вашим початковим файлом.

Чому не вдалася конвертація в TOML?

TOML потребує таблиці на верхньому рівні, тож масив або окреме значення представити неможливо. Крім того, у TOML немає null: ключі зі значенням null відкидаються замість того, щоб зламати весь документ.

Що таке JSONL і коли його використовувати?

JSONL — також відомий як NDJSON — розміщує по одному компактному документу JSON у кожному рядку. Його використовують конвеєри логів і набори даних для машинного навчання, бо читач може обробляти його потоково, запис за записом, замість того щоб спершу розбирати весь файл.