Darmowy konwerter online JSON do CSV

Arkusz kalkulacyjny, importer bazy danych lub system raportowania może wymagać tabelarycznego formatu CSV zamiast struktury JSON. Konwersja danych ułatwia edytowanie płaskich rekordów w Excelu lub LibreOffice Calc i zapewnia układ oczekiwany przez wiele narzędzi do importu zbiorczego.

Czym jest JSON

JSON (JavaScript Object Notation) to format tekstowy zbudowany z obiektów, tablic, par klucz-wartość, liczb, ciągów znaków, wartości logicznych i null. Interfejsy API sieci Web, aplikacje przeglądarkowe, systemy konfiguracji, bazy danych i języki programowania często generują pliki z rozszerzeniem .json.

JSON może przechowywać zagnieżdżone obiekty i tablice, dlatego jeden rekord może zawierać kilka poziomów powiązanych danych. Ta elastyczność nie odwzorowuje się bezpośrednio na płaską tabelę arkusza kalkulacyjnego. Plik JSON Lines lub NDJSON, w którym każdy wiersz jest osobnym obiektem JSON, również wymaga innej procedury importu niż jeden standardowy dokument JSON.

Czym jest CSV

CSV (comma-separated values) przedstawia rekordy tabelaryczne w postaci wierszy, z jednym polem w każdej kolumnie. Pierwszy wiersz często zawiera nazwy kolumn. Pole zawierające separator, znak cudzysłowu lub podział wiersza musi być ujęte w cudzysłowy; znaki cudzysłowu wewnątrz takiego pola są zwykle reprezentowane przez dwa znaki cudzysłowu.

Excel, LibreOffice Calc, importery baz danych, oprogramowanie statystyczne i skrypty do przetwarzania danych obsługują CSV. Format ten dobrze sprawdza się w przypadku płaskich list, filtrowania, sortowania i importu zbiorczego, ale natywnie nie zachowuje zagnieżdżonych obiektów, tablic, typów danych, formuł ani formatowania komórek. Implementacje CSV mogą używać średnika lub tabulatora zamiast przecinka, dlatego należy sprawdzić wymagania dotyczące separatora w systemie docelowym.

Jak przekonwertować plik

W przypadku jednorazowej konwersji użyj bezpłatnego konwertera JSON-to-CSV na stronie 101convert.com, bez instalowania oprogramowania:

1. Otwórz konwerter i prześlij plik .json lub wklej dokument JSON.
2. Jeśli dostępne są opcje wyboru pól lub spłaszczania, wybierz tablicę zawierającą rekordy oraz pola, które powinny stać się kolumnami.
3. Rozpocznij konwersję i pobierz wynikowy plik .csv.
4. Otwórz plik CSV w LibreOffice Calc, Excelu lub innej aplikacji arkusza kalkulacyjnego i sprawdź separator, kodowanie znaków, nagłówki, liczbę wierszy oraz reprezentatywne wartości.

Nie przesyłaj poufnych ani podlegających regulacjom danych, chyba że usługa jest zatwierdzona do przetwarzania takich danych.

W przypadku powtarzalnych lub prywatnych konwersji standardowe moduły biblioteki json i csv języka Python pozwalają uniknąć instalowania dodatkowego pakietu. Ten przykład zakłada tablicę obiektów na najwyższym poziomie:

import csv
import json

with open("input.json", encoding="utf-8") as source:
    records = json.load(source)

if not isinstance(records, list) or any(not isinstance(record, dict) for record in records):
    raise ValueError("Expected a top-level array of objects")

columns = list(dict.fromkeys(
    key for record in records for key in record
))

with open("output.csv", "w", newline="", encoding="utf-8-sig") as target:
    writer = csv.DictWriter(
        target, fieldnames=columns, extrasaction="ignore"
    )
    writer.writeheader()
    writer.writerows(records)

Zapisz kod jako json_to_csv.py i uruchom polecenie python json_to_csv.py. Skrypt zachowuje kolejność pierwszego wystąpienia kluczy, zapisuje puste komórki dla brakujących kluczy i pozostawia zagnieżdżone wartości nieprzystosowane do płaskiej konwersji CSV. Kodowanie utf-8-sig dodaje znacznik kolejności bajtów UTF-8, który pomaga niektórym wersjom programu Excel dla systemu Windows wykrywać tekst Unicode; użyj zwykłego utf-8, gdy system odbierający dane nie akceptuje znacznika kolejności bajtów.

Niektóre wersje programu Microsoft Excel mogą importować JSON za pośrednictwem Data → Get Data → From File → From JSON. W Power Query rozwiń listę lub rekord najwyższego poziomu, rozwiń zagnieżdżone rekordy do kolumn, a następnie użyj Close & Load; wyeksportuj wynikową tabelę za pomocą File → Save As i wybierz CSV. Jeśli zainstalowana wersja programu Excel nie ma tego konektora, najpierw przekonwertuj plik, a następnie otwórz CSV za pomocą okna dialogowego importu. W LibreOffice Calc użyj polecenia File → Open dla wynikowego pliku CSV i wybierz UTF-8, wymagany separator oraz prawidłowy znak cudzysłowu.

Ograniczenia jakości i zgodności

Najwygodniejsze dane wejściowe to tablica na najwyższym poziomie, taka jak [{"id":1,"name":"A"},{"id":2,"name":"B"}]. Obiekt na najwyższym poziomie może reprezentować jeden rekord, zawierać właściwą tablicę rekordów jako opakowanie lub przechowywać niepowiązane metadane. Przed utworzeniem znaczących wierszy konwerter musi zidentyfikować właściwą tablicę.

Zagnieżdżone obiekty i tablice wymagają określenia odpowiedniej strategii. Można je spłaszczyć do kolumn takich jak address.city, zserializować jako tekst JSON w jednym ujętym w cudzysłowy polu CSV albo pominąć. Wartości tablicowe można połączyć w tekst. Różne konwertery stosują różne strategie, dlatego należy sprawdzić zagnieżdżone pola i kilka wierszy wyjściowych, a nie tylko nagłówki.

CSV nie zapewnia niezawodnego, natywnego rozróżniania liczb, dat, wartości logicznych i ciągów znaków. Oprogramowanie arkuszy kalkulacyjnych może automatycznie konwertować identyfikatory, początkowe zera, długie liczby całkowite lub daty ISO. Importuj kolumny jako tekst, gdy ich pierwotna postać musi pozostać niezmieniona, i upewnij się, że puste wartości, null oraz brakujące pola mają wymagane znaczenie.

Używaj UTF-8 dla znaków spoza ASCII i potwierdź, czy system docelowy oczekuje przecinków, średników, tabulatorów, zakończeń wierszy CRLF lub znacznika kolejności bajtów. Traktuj niezaufane pliki CSV jako potencjalnie niebezpieczne w oprogramowaniu arkuszy kalkulacyjnych: wartości zaczynające się od =, +, - lub @ mogą zostać zinterpretowane jako formuły. Sprawdź takie wartości lub zneutralizuj je przed otwarciem pliku.