Online konvertor JSON do CSV zdarma

Tabulkový procesor, importér databází nebo systém pro tvorbu reportů může vyžadovat tabulkový formát CSV namísto strukturovaného JSON. Převod dat usnadňuje úpravu plochých záznamů v Excelu nebo LibreOffice Calc a poskytuje rozložení očekávané mnoha nástroji pro hromadný import.

Co je JSON

JSON (JavaScript Object Notation) je textový formát tvořený objekty, poli, dvojicemi klíč-hodnota, čísly, řetězci, logickými hodnotami a null. Webová API, aplikace v prohlížeči, konfigurační systémy, databáze a programovací jazyky běžně vytvářejí soubory s příponou .json.

JSON může ukládat vnořené objekty a pole, takže jeden záznam může obsahovat několik úrovní souvisejících dat. Tato flexibilita se přímo nepřenáší do ploché tabulky v tabulkovém procesoru. Soubor JSON Lines nebo NDJSON, ve kterém je každý řádek samostatným objektem JSON, také vyžaduje jiný postup importu než jeden standardní dokument JSON.

Co je CSV

CSV (comma-separated values) představuje tabulkové záznamy jako řádky, přičemž každý údaj je v samostatném sloupci. První řádek často obsahuje názvy sloupců. Údaj obsahující oddělovač, uvozovky nebo zalomení řádku musí být uzavřen v uvozovkách; uvozovky uvnitř takového údaje se obvykle zapisují jako dvě uvozovky.

Excel, LibreOffice Calc, importéry databází, statistický software a skripty pro zpracování dat podporují CSV. Dobře se hodí pro ploché seznamy, filtrování, řazení a hromadné importy, ale nativně nezachovává vnořené objekty, pole, datové typy, vzorce ani formátování buněk. Implementace CSV mohou místo čárky používat středník nebo tabulátor, proto je nutné ověřit požadavek cílového systému na oddělovač.

Jak soubor převést

Pro jednorázový převod použijte bezplatný převodník JSON-to-CSV na webu 101convert.com, aniž byste museli instalovat software:

1. Otevřete převodník a nahrajte soubor .json nebo vložte dokument JSON.
2. Pokud jsou k dispozici možnosti výběru polí nebo zploštění, vyberte pole obsahující záznamy a pole, která se mají stát sloupci.
3. Spusťte převod a stáhněte výsledný soubor .csv.
4. Otevřete CSV v LibreOffice Calc, Excelu nebo jiné tabulkové aplikaci a ověřte oddělovač, kódování znaků, záhlaví, počet řádků a reprezentativní hodnoty.

Nenahrávejte důvěrná data ani data podléhající regulaci, pokud daná služba není pro taková data schválena.

Pro opakované nebo soukromé převody se můžete vyhnout dalšímu balíčku použitím standardních modulů json a csv v Pythonu. Tento příklad očekává pole objektů na nejvyšší úrovni:

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)

Uložte kód jako json_to_csv.py a spusťte python json_to_csv.py. Skript zachovává pořadí, ve kterém se klíče poprvé objeví, zapisuje prázdné buňky pro chybějící klíče a ponechává vnořené hodnoty nevhodné pro převod do plochého CSV. Kódování utf-8-sig přidává značku pořadí bajtů UTF-8, která některým verzím Excelu pro Windows pomáhá rozpoznat text Unicode; pokud přijímající systém značku pořadí bajtů nepřijímá, použijte běžné utf-8.

Některé verze Microsoft Excelu mohou importovat JSON prostřednictvím Data → Get Data → From File → From JSON. V Power Query rozbalte seznam nebo záznam na nejvyšší úrovni, rozbalte vnořené záznamy do sloupců a poté použijte Close & Load; výslednou tabulku exportujte pomocí File → Save As a vyberte CSV. Pokud nainstalovaná verze Excelu tento konektor neobsahuje, nejprve soubor převeďte a otevřete CSV prostřednictvím dialogu importu. V LibreOffice Calc použijte pro výsledné CSV File → Open a vyberte UTF-8, požadovaný oddělovač a správný znak uvozovek.

Omezení kvality a kompatibility

Nejvhodnějším vstupem je pole na nejvyšší úrovni, například [{"id":1,"name":"A"},{"id":2,"name":"B"}]. Objekt na nejvyšší úrovni může představovat jeden záznam, obálku obsahující skutečné pole záznamů nebo nesouvisející metadata. Před vytvořením smysluplných řádků musí převodník určit zamýšlené pole.

Vnořené objekty a pole vyžadují explicitní pravidla. Lze je zploštit do sloupců, jako je address.city, serializovat jako text JSON uvnitř jednoho CSV pole v uvozovkách nebo vynechat. Hodnoty polí lze spojit do textu. Různé převodníky používají různá pravidla, proto zkontrolujte vnořená pole a několik řádků výstupu, nikoli pouze záhlaví.

CSV nemá spolehlivé nativní rozlišení mezi čísly, daty, logickými hodnotami a řetězci. Tabulkový software může automaticky převádět identifikátory, počáteční nuly, dlouhá celá čísla nebo data ISO. Pokud musí původní zápis zůstat nezměněn, importujte sloupce jako text a ověřte, že prázdné hodnoty, null a chybějící pole mají požadovaný význam.

Pro znaky mimo ASCII používejte UTF-8 a ověřte, zda cílový systém očekává čárky, středníky, tabulátory, konce řádků CRLF nebo značku pořadí bajtů. S nedůvěryhodnými soubory CSV zacházejte v tabulkovém softwaru jako s potenciálně nebezpečnými: hodnoty začínající na =, +, - nebo @ mohou být interpretovány jako vzorce. Před otevřením souboru takové hodnoty zkontrolujte nebo neutralizujte.