- Strona główna
- Narzędzia
- Spłaszcz JSON do JSONL
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łceniu | Wybierz, gdy |
|---|---|---|
| Rozwinięcie według indeksów | items.0.sku = A, items.1.sku = B — jeden wiersz, więcej kolumn | Liczba wierszy musi być taka sama jak w danych wejściowych, a tablice są krótkie i mają ograniczony rozmiar |
| Rozwinięcie na wiersze | Dwa wiersze, każdy z items.sku — więcej wierszy, stały zestaw kolumn | Dane mają być przetwarzane w SQL lub narzędziach analitycznych, a każdy element tablicy stanowi osobny rekord |
| Zapis jako ciąg znaków z JSON | items = "[{\"sku\":\"A\"},...]" — jedna komórka bez wglądu w strukturę danych | Tablica 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
Konwertuj tablice JSON na JSONL. To idealny sposób na przygotowanie danych do przetwarzania strumieniowego i trenowania modeli ML.
Eksportuj dane JSONL do arkuszy CSV, aby wygodnie analizować je w Excelu lub Google Sheets.
Konwertuj dane JSONL na arkusze w natywnym formacie Excela (.xlsx). To idealne rozwiązanie do raportowania biznesowego, analizy danych i udostępniania ich osobom nietechnicznym.
Waliduj pliki JSONL linia po linii. Od razu wykrywaj błędy składni, problemy z kodowaniem i niezgodności z formatem.
Sposoby przetwarzania gigabajtów danych JSONL: odczyt strumieniowy, zarządzanie pamięcią, dzielenie plików, kompresja i narzędzia online.