Spłaszcz JSON do JSONL

Wyodrębnij rekordy z zagnieżdżonych obiektów i tablic JSON i spłaszcz je do formatu JSONL (JSON Lines). Każdy rekord zajmuje osobną linię. W 100% po stronie klienta.

Wejściowy JSON

Upuść tutaj plik .json lub kliknij, aby wybrać plik

Obsługiwane pliki: .json, .txt

Wynikowy JSONL

Wklej zagnieżdżony JSON lub upuść plik, aby spłaszczyć dane do JSONL

Czym jest spłaszczanie JSON?

Spłaszczanie JSON polega na przekształceniu głęboko zagnieżdżonej struktury JSON w płaski format z rekordami zapisanymi w osobnych liniach. Klucze zagnieżdżonych obiektów są zapisywane w notacji kropkowej (np. address.city), a tablice obiektów są rozwijane tak, aby każdy element stał się osobnym rekordem w formacie JSONL.

Przydaje się to zwłaszcza wtedy, gdy odpowiedzi API lub dane wyeksportowane z bazy mają złożoną, zagnieżdżoną strukturę i potrzebujesz płaskiego formatu tabelarycznego do trenowania modeli uczenia maszynowego, konwersji do CSV lub strumieniowego przetwarzania danych w potokach wymagających jednego rekordu na linię.

Dwa sposoby spłaszczania tablicy — wybierz zależnie od przeznaczenia danych

Zagnieżdżone obiekty spłaszcza się w oczywisty sposób: łącząc klucze kropkami. W przypadku tablic trzeba jednak wybrać sposób ich przekształcenia. Właściwa strategia zależy od tego, dokąd trafią spłaszczone dane:

Strategia[{"sku":"A"},{"sku":"B"}] po przekształceniuWybierz, gdy
Rozwinięcie według indeksówitems.0.sku = A, items.1.sku = B — jeden wiersz, więcej kolumnLiczba wierszy musi być taka sama jak w danych wejściowych, a tablice są krótkie i mają ograniczony rozmiar
Rozwinięcie na wierszeDwa wiersze, każdy z items.sku — więcej wierszy, stały zestaw kolumnDane mają być przetwarzane w SQL lub narzędziach analitycznych, a każdy element tablicy stanowi osobny rekord
Zapis jako ciąg znaków z JSONitems = "[{\"sku\":\"A\"},...]" — jedna komórka bez wglądu w strukturę danychTablica zawiera metadane, które sparsujesz ponownie później, a nie dane, które chcesz teraz odpytywać

Jak spłaszczyć JSON do JSONL

Spłaszczanie JSON do JSONL polega na wyodrębnieniu rekordów z zagnieżdżonych struktur i zapisaniu każdego z nich w osobnej linii JSONL. Jeśli JSON zawiera tablicę obiektów, każdy jej element trafia do jednej linii. Klucze zagnieżdżonych obiektów są zapisywane w notacji kropkowej.

Narzędzie działa w całości w przeglądarce. Żadne dane nie są wysyłane na serwer. Wklej zagnieżdżony JSON lub przeciągnij i upuść plik, a od razu zobaczysz spłaszczony wynik w formacie JSONL. Pola z poziomu nadrzędnego są automatycznie dołączane do każdego rekordu.

Wynikiem jest poprawny plik JSONL z jednym obiektem JSON w każdej linii, zapisanym bez zbędnych odstępów. Możesz skopiować wynik do schowka lub pobrać go jako plik .jsonl, gotowy do wykorzystania w uczeniu maszynowym, potokach przetwarzania danych lub do importu do bazy danych.

Przed i po

Przykładowy zagnieżdżony rekord zbliżony do rzeczywistych danych i jego płaska postać po rozwinięciu tablic według indeksów. Zwróć uwagę na wybór separatora: jeśli użyjesz kropek, klucz zapisany w źródle jako "config.debug" będzie kolidował ze spłaszczoną ścieżką config.debug. Jeśli klucze zawierają kropki, zmień separator na znak podkreślenia:

// Przed — zagnieżdżony rekord:
{"user": {"id": 7, "address": {"city": "Osaka", "zip": "530-0001"}}, "tags": ["vip", "beta"]}


// Po — spłaszczenie z separatorem kropkowym i rozwinięciem indeksów tablic:
{"user.id": 7, "user.address.city": "Osaka", "user.address.zip": "530-0001", "tags.0": "vip", "tags.1": "beta"}

Spłaszczanie to standardowy etap przygotowania danych przed eksportem do CSV lub Excela — te formaty są tabelaryczne i nie pozwalają przedstawić zagnieżdżeń. Głęboko zagnieżdżone dane wejściowe mogą dać wynik z bardzo dużą liczbą kolumn, dlatego najpierw spłaszcz próbkę i sprawdź, czy liczba kolumn jest rozsądna, zanim przetworzysz cały plik.

Typowe zastosowania

Przetwarzanie odpowiedzi API
Spłaszczaj zagnieżdżone odpowiedzi API do JSONL, aby ułatwić parsowanie, zapisywanie w logach i dalsze przetwarzanie w potokach danych.
Transformacja danych w procesach ETL
Wyodrębniaj rekordy ze złożonych eksportów JSON i spłaszczaj je do JSONL, aby wczytać je do baz lub hurtowni danych.
Przygotowanie zbiorów danych ML
Przekształcaj zagnieżdżone zbiory danych JSON w płaskie rekordy JSONL wymagane przez OpenAI, Hugging Face i inne platformy do trenowania modeli ML.
Przetwarzanie logów i analityka
Spłaszczaj ustrukturyzowane logi z zagnieżdżonymi metadanymi do JSONL, aby analizować je za pomocą narzędzi takich jak grep, jq czy Elasticsearch.
Generowanie danych testowych
Spłaszczaj złożone, zamockowane odpowiedzi API w formacie JSON do pojedynczych rekordów JSONL, które posłużą jako dane testowe (fixtures) w zestawach testów automatycznych.
Migracja baz danych
Spłaszczaj zagnieżdżone eksporty dokumentów JSON z MongoDB lub CouchDB do płaskich rekordów JSONL, aby zaimportować je do relacyjnych baz danych, takich jak PostgreSQL.

Częste błędy i sposoby ich rozwiązania

Nie znaleziono rekordów do spłaszczenia

Ten błąd występuje, gdy wejściowy JSON jest wartością prostą (ciągiem znaków lub liczbą), pustym obiektem lub pustą tablicą. Do wyodrębnienia rekordów narzędzie potrzebuje obiektów lub tablic obiektów. Upewnij się, że JSON zawiera co najmniej jeden obiekt z parami klucz–wartość.

Konflikty kluczy w notacji kropkowej

Jeśli JSON zawiera na najwyższym poziomie klucz "user.name", a także zagnieżdżoną strukturę {"user":{"name":"value"}}, po spłaszczeniu oba zapisy dadzą ten sam klucz w notacji kropkowej. Wartość z zagnieżdżonej struktury nadpisze wartość z najwyższego poziomu. Przed spłaszczeniem zmień nazwy kolidujących kluczy.

Odwołania cykliczne w JSON

Standardowy JSON nie może zawierać odwołań cyklicznych, ale niektóre generatory JSON tworzą bardzo głęboko zagnieżdżone struktury, które mogą je przypominać. Narzędzie radzi sobie z głębokim zagnieżdżeniem w rozsądnych granicach, ale przerwie spłaszczanie, jeśli struktura przekroczy bezpieczne limity.

Najczęściej zadawane pytania

Jak działa spłaszczanie zagnieżdżonych obiektów?

Klucze zagnieżdżonych obiektów są zapisywane w notacji kropkowej. Na przykład {"user":{"address":{"city":"NYC"}}} zmienia się w {"user.address.city":"NYC"}. Dzięki temu głęboko zagnieżdżone dane są dostępne jako płaskie pary klucz–wartość.

Co się dzieje z tablicami w danych JSON?

Jeśli JSON zawiera tablicę obiektów, każdy obiekt trafia do osobnej linii JSONL. Tablice wartości prostych (ciągów znaków, liczb) są serializowane do ciągów znaków zawierających JSON i w tej postaci umieszczane w spłaszczonym wyniku. Narzędzie automatycznie wykrywa główną tablicę do rozwinięcia.

Czy moje dane są bezpieczne podczas spłaszczania?

Tak. Całe spłaszczanie odbywa się lokalnie w przeglądarce. Żadne dane nie są wysyłane na serwer. Zawartość JSON nigdy nie opuszcza twojego urządzenia.

Czy mogę spłaszczyć JSON z różnymi poziomami zagnieżdżenia?

Tak. Narzędzie obsługuje dowolny poziom zagnieżdżenia. Pola skalarne z najwyższego poziomu są dołączane do każdego rekordu, klucze zagnieżdżonych obiektów są zapisywane w notacji kropkowej, a największa tablica obiektów jest rozwijana do osobnych linii JSONL.

Jak podczas spłaszczania obsługiwane są wartości null i undefined?

Wartości null pozostają w spłaszczonym wyniku jako null. JSON nie ma typu undefined, więc takie wartości nie występują. Puste obiekty po spłaszczeniu nie tworzą żadnych kluczy, a puste tablice są serializowane jako puste tablice JSON.

Czy mogę spłaszczyć wiele plików JSON jednocześnie?

Obecnie narzędzie przetwarza jeden zestaw danych JSON naraz. Aby spłaszczyć wiele plików, przetwarzaj je po kolei. Do przetwarzania wsadowego rozważ użycie narzędzi wiersza poleceń, takich jak jq, a tego narzędzia użyj do wizualnego sprawdzenia wyników.

Jaką maksymalną głębokość zagnieżdżenia obsługuje to narzędzie?

Narzędzie obsługuje głębokości zagnieżdżenia spotykane w rzeczywistych danych JSON (zazwyczaj do 20+ poziomów). Nie ma sztywnego limitu głębokości, ale przy bardzo głębokim zagnieżdżeniu w wyniku mogą powstać bardzo długie klucze w notacji kropkowej.

Czym to narzędzie różni się od zwykłej konwersji JSON do JSONL?

Konwersja JSON do JSONL umieszcza każdy element tablicy z najwyższego poziomu w osobnej linii. Spłaszczanie JSON do JSONL dodatkowo rozwija zagnieżdżone struktury, zapisuje klucze zagnieżdżonych obiektów w notacji kropkowej i dołącza pola z poziomu nadrzędnego do każdego rekordu. Użyj spłaszczania, gdy potrzebujesz wyodrębnić rekordy z głęboko zagnieżdżonego JSON.

Powiązane narzędzia i przewodniki