JSON, YAML, CSV: Κατανοώντας πότε και γιατί να μετατρέπετε μεταξύ μορφοτύπων

Ένας DevOps μηχανικός εξάγει μια διαμόρφωση Kubernetes ως YAML αλλά χρειάζεται να τη στείλει σε ένα API που δέχεται μόνο JSON. Ένας αναλυτής λαμβάνει δεδομένα απόκρισης API σε JSON αλλά τα χρειάζεται σε υπολογιστικό φύλλο. Ένας επιστήμονας δεδομένων εξάγει CSV από μια βάση δεδομένων αλλά χρειάζεται δομημένο JSON για ένα web dashboard.

Η μετατροπή μορφοτύπων δεν είναι απλά μια μηχανική λειτουργία. Κάθε μορφότυπο κάνει διαφορετικούς συμβιβασμούς, και η κατανόηση του τι χάνεται στη μετάφραση είναι εξίσου σημαντική με το να γνωρίζετε πώς να μετατρέπετε.

Τρεις μορφότυποι, τρεις φιλοσοφίες

Κάθε μορφότυπος σχεδιάστηκε για διαφορετικό κοινό και διαφορετικό πρόβλημα:

Ο CSV υποθέτει ότι τα δεδομένα σας είναι ένας επίπεδος πίνακας. Κάθε τιμή είναι ένα string. Δεν υπάρχει έννοια ένθεσης, τυποποίησης ή μεταδεδομένων.

Ο JSON υποθέτει ότι τα δεδομένα σας έχουν δομή — αντικείμενα, πίνακες, τύπους (strings, αριθμούς, booleans, null). Είναι αυστηρός και σαφής, ιδανικός για μηχανές αλλά πολυλογάς για ανθρώπους.

Ο YAML υποθέτει ότι ένας άνθρωπος θα διαβάσει και θα επεξεργαστεί το αρχείο. Χρησιμοποιεί εσοχές αντί για αγκύλες, υποστηρίζει σχόλια και έχει πιο χαλαρή σύνταξη. Τεχνικά, ο YAML είναι υπερσύνολο του JSON — κάθε έγκυρο JSON έγγραφο είναι επίσης έγκυρο YAML.

Πραγματικά σενάρια μετατροπής

Μεταφορά διαμόρφωσης (JSON σε YAML, YAML σε JSON)

Αυτή είναι η πιο συνηθισμένη μετατροπή. Διαφορετικά εργαλεία περιμένουν διαφορετικούς μορφότυπους διαμόρφωσης:

• Docker Compose, Kubernetes, GitHub Actions, Ansible χρησιμοποιούν YAML
• package.json, tsconfig.json, ESLint χρησιμοποιούν JSON
• Η μετάβαση μεταξύ εργαλείων σημαίνει συχνά μετατροπή διαμορφώσεων

Αυτή η μετατροπή είναι χωρίς απώλειες και στις δύο κατευθύνσεις για το περιεχόμενο δεδομένων — αλλά τα σχόλια YAML χάνονται κατά τη μετατροπή σε JSON, αφού ο JSON δεν έχει σύνταξη σχολίων.

Ανάλυση δεδομένων (JSON σε CSV)

Οι απαντήσεις API έρχονται σε JSON. Οι αναλυτές χρειάζονται υπολογιστικά φύλλα. Αυτή η μετατροπή λειτουργεί καλά για επίπεδους JSON πίνακες — πίνακες αντικειμένων με ταυτόσημα κλειδιά αντιστοιχίζονται φυσικά σε γραμμές και στήλες.

Αλλά αποτυγχάνει με ένθετα δεδομένα. Ένα JSON αντικείμενο με πεδίο address.city και πίνακα skills δεν έχει φυσική CSV αναπαράσταση. Ο μετατροπέας πρέπει να επιλέξει: ισοπέδωση ένθετων κλειδιών (address.city γίνεται στήλη), σειριοποίηση ένθετων τιμών ως strings ή απόρριψή τους.

Εισαγωγή δεδομένων (CSV σε JSON)

Το αντίστροφο σενάριο: εισαγωγή δεδομένων υπολογιστικού φύλλου σε web εφαρμογή ή API. Η μετατροπή CSV σε JSON δημιουργεί πίνακα αντικειμένων με τις κεφαλίδες στηλών ως κλειδιά. Το πρόβλημα είναι ότι ο CSV δεν έχει πληροφορίες τύπου — ο αριθμός 42, το string "42" και το boolean true είναι όλα απλά κείμενο στο CSV. Ο μετατροπέας πρέπει να μαντέψει τύπους.

Αναγνωσιμότητα (JSON σε YAML)

Μερικές φορές χρειάζεται απλά να κάνετε ένα πυκνό JSON αρχείο διαμόρφωσης αναγνώσιμο. Η μετατροπή σε YAML δίνει καθαρές εσοχές και τη δυνατότητα προσθήκης σχολίων για τεκμηρίωση. Αυτό είναι ιδιαίτερα πολύτιμο για μεγάλα αρχεία διαμόρφωσης που θα συντηρηθούν από ομάδα.

Τι χάνεται στη μετατροπή

Αυτή είναι η κρίσιμη γνώση που εξοικονομεί χρόνο αποσφαλμάτωσης:

Το μοτίβο είναι σαφές: οι μετατροπές προς CSV χάνουν τις περισσότερες πληροφορίες, γιατί ο CSV είναι ο απλούστερος μορφότυπος. Οι μετατροπές μεταξύ JSON και YAML είναι σχεδόν χωρίς απώλειες. Και τα σχόλια YAML χάνονται πάντα κατά την έξοδο από YAML.

Συνήθεις παγίδες κατά τη μετατροπή

Παγίδες εξαναγκασμού τύπων του YAML

Ο YAML ερμηνεύει αυτόματα ορισμένα strings ως μη-string τύπους. Η λέξη no γίνεται boolean false. Η λέξη yes γίνεται true. Το string 1.0 γίνεται float. Κωδικοί χωρών όπως NO (Νορβηγία) έχουν προκαλέσει διάσημα bugs. Πάντα βάζετε εισαγωγικά σε αμφίσημες τιμές στο YAML.

Σύγχυση διαχωριστή και κωδικοποίησης CSV

Δεν χρησιμοποιούν όλα τα CSV κόμμα. Τα ευρωπαϊκά CSV χρησιμοποιούν συχνά ερωτηματικό (επειδή το κόμμα είναι δεκαδικός διαχωριστής σε πολλούς ευρωπαϊκούς αριθμητικούς μορφότυπους). Οι τιμές χωρισμένες με tab (TSV) είναι μια άλλη παραλλαγή. Και αναντιστοιχίες κωδικοποίησης χαρακτήρων (UTF-8 vs Latin-1) παράγουν αλλοιωμένους τονισμένους χαρακτήρες.

Πρόβλημα τελικού κόμματος στο JSON

Ο JSON δεν επιτρέπει τελικά κόμματα. Αυτό είναι έγκυρη JavaScript: {"a": 1, "b": 2,} — αλλά είναι μη έγκυρο JSON. Ένα μόνο τελικό κόμμα προκαλεί σφάλμα ανάλυσης.

Απόδοση μεγάλων συνόλων δεδομένων

Για σύνολα δεδομένων με εκατομμύρια γραμμές, ο CSV είναι σημαντικά πιο αποδοτικός από JSON ή YAML. Ο JSON προσθέτει αγκύλες και εισαγωγικά για κάθε τιμή. Ένα CSV με 1 εκατομμύριο γραμμές μπορεί να είναι 50 MB· το αντίστοιχο JSON θα μπορούσε να είναι 150 MB.

Επιλογή του σωστού μορφότυπου από την αρχή

Αντί να μετατρέπετε εκ των υστέρων, η σωστή επιλογή μορφότυπου εξαρχής αποφεύγει την απώλεια πληροφοριών:

• Πινακοποιημένα δεδομένα για υπολογιστικά φύλλα ή βάσεις δεδομένων — CSV
• Δομημένα δεδομένα για APIs ή web εφαρμογές — JSON
• Διαμόρφωση που θα επεξεργαστούν άνθρωποι — YAML
• Σύνθετα ένθετα δεδομένα με σχόλια — YAML
• Ανταλλαγή δεδομένων μεταξύ συστημάτων — JSON

Μάθετε περισσότερα

Μετατρέψτε μεταξύ JSON, YAML και CSV αμέσως με εργαλεία browser:

• Μετατροπή μορφοτύπων δεδομένων — επικολλήστε τα δεδομένα σας, επιλέξτε μορφότυπο-στόχο, κατεβάστε το αποτέλεσμα
• Μορφοποιητής JSON — επικύρωση, μορφοποίηση και ελαχιστοποίηση JSON
• Μετατροπέας JSON σε CSV — μετατροπή πινάκων JSON σε CSV έτοιμο για υπολογιστικό φύλλο
• Μετατροπέας YAML-JSON — μετατροπή μεταξύ YAML και JSON με επίγνωση σχολίων