CSV JSON'a Nasıl Çevrilir: Tablo Satırlarını Temiz Nesnelere Dönüştürün

Tablolar ve kod farklı diller konuşur. Bir CSV dosyası, Excel’de satırları tarayan bir insan için mükemmeldir; ancak o veriyi bir API’ye, bir yapılandırma dosyasına ya da bir JavaScript uygulamasına beslemeniz gerektiği anda istediğiniz şey JSON olur. İkisi arasında çevrim yapmak, geliştirmenin rutin bir parçasıdır ve saniyeler sürmelidir. Bu rehber, çevrim sırasında aslında ne olduğunu ve ücretsiz CSV’den JSON’a aracıyla bunu gizlilik içinde nasıl yapacağınızı anlatır.

CSV ve JSON neyde iyidir

CSV (virgülle ayrılmış değerler) düz, tablo biçiminde bir formattır. Her satır bir satırdır ve virgüller sütunları ayırır. Derli topludur, herhangi bir tablo programında açılır ve geliştirici olmayanların okuması ile düzenlemesi kolaydır. Yapamadığı şey ise yapıyı ifade etmektir: verileri iç içe yerleştirmenin ya da bir başlık satırının ötesinde her değerin ne anlama geldiğini etiketlemenin temiz bir yolu yoktur.

JSON (JavaScript Nesne Gösterimi) yapı için tasarlanmıştır. Adlandırılmış anahtarlar kullanır, iç içe yerleştirmeyi destekler ve web API’lerinin ile JavaScript uygulamalarının varsayılan dilidir. Kodunuzun kayıtlar üzerinde dönmesi ve alanları ada göre okuması gerektiğinde, beklediği şey JSON’dur.

Yani çevrim aslında ‘bir insanın okuduğu bir ızgaradan’ ‘bir programın okuduğu etiketli kayıtlara’ yapılan bir çeviridir.

Satırlar nesnelere nasıl dönüşür

Bir kez gördüğünüzde mekanik basittir. Şu CSV’yi ele alın:

• name,email,age
• Ada,[email protected],36
• Linus,[email protected],29

İlk satır başlıktır. Kalan her satır bir JSON nesnesine dönüşür ve her başlık hücresi bir anahtar olur. Sonuç, bir nesne dizisidir: [{"name": "Ada", "email": "[email protected]", "age": "36"}, ...]. Bir satır girer, bir nesne çıkar ve etiketlemeyi sütun adları yapar.

Bu dizi biçimi, çoğu API’nin ve ön uç çatısının almak istediği şeyin tam olarak kendisidir; bu çevrimin bu kadar sık karşımıza çıkmasının nedeni de budur.

Geliştiriciler CSV’yi neden JSON’a çevirir

Tablo biçimindeki verilerin kodla buluşması gerektiğinde buna başvurursunuz. Yaygın durumlar şunları içerir:

• Bir uygulamayı veya veritabanını doldurmak, birinin Excel veya Google Sheets’te tuttuğu bir listeden.
• Bir API’ye veri göndermek, yalnızca JSON gövdesini kabul eden bir API’ye.
• Bir ön ucu beslemek, burada bir JSON dizisi doğrudan bir bileşen listesine eşlenir.
• Testler için sabit veri (fixture) yazmak, hızlıca hazırlanmış bir vaka tablosunu yapılandırılmış girdiye dönüştürmek.

Her durumda bir iş arkadaşı kaynağı tablo olarak rahatça tutabilirken kodunuz JSON’u tüketir.

CSV’yi tarayıcınızda JSON’a nasıl çevirirsiniz

Ücretsiz CSV’den JSON’a aracı tamamen tarayıcınızda çalışır, dolayısıyla verileriniz hiçbir zaman bir sunucuya yüklenmez. Satırlar müşteri kayıtları, e-postalar ya da gelişigüzel bir web sitesine yapıştırmayacağınız herhangi bir şey içerdiğinde bu önemlidir.

1. Aracı açın ve CSV’nizi yapıştırın ya da bir .csv dosyası yükleyin.
2. İlk satırın başlığınız olduğundan emin olun. O hücreler her nesnedeki anahtarlar olur.
3. JSON çıktısını, yani bir nesne dizisini okuyun ve doğrudan kodunuza veya yapılandırmanıza kopyalayın.

İş sekmede gerçekleştiği için hassas verileri makinenizden çıkmadan güvenle çevirebilirsiniz.

Başlıklar, türler ve birkaç tuzak

Temiz bir çevrim çoğunlukla temiz girdiye bağlıdır. Şunları aklınızda tutun:

• Başlık satırı her şeyi yönetir. Bir sütunun başlığı yoksa, değerlerinin anlamlı bir şekilde yerleşeceği bir yer olmaz. Her sütunu adlandırın.
• Değerler metin (string) olarak çıkar. Bir CSV türleri kaydetmez, bu yüzden 36, "36" olarak gelir. Aritmetik gerekiyorsa kodunuzda sayıya dönüştürün.
• Virgül içeren alanları tırnak içine alın. Smith, Jr. gibi bir değer CSV’de tırnak içine alınmalıdır, aksi takdirde iki sütun olarak okunur.

Çıktı bozuk göründüğünde, neden neredeyse her zaman kaynaktaki eksik bir başlık ya da tırnağa alınmamış bir virgüldür.

Muhtemelen isteyeceğiniz ilgili araçlar

Çevrim her iki yönde de çalışır. Yapılandırılmış veriyi birine tablo olarak geri vermeniz gerektiğinde, JSON’dan CSV’ye aracı onu yeniden satırlara düzleştirir. JSON’unuz olduğunda, JSON Biçimlendirici onu girintiler ve doğrular; böylece yapıyı gerçekten okuyabilir ve kaçak bir köşeli parantezi yakalayabilirsiniz. Kaynak veriniz bir tablo yerine XML olarak geldiyse, XML’den JSON’a aracı onu kodunuzun beklediği aynı nesne biçimine getirir.

Kısa özet

CSV insanlar için bir ızgaradır; JSON ise kod için etiketli kayıtlardır. Çevirmek, başlık satırının anahtarları sağlamasıyla her satırı bir nesneye dönüştürmek demektir. Başlıklarınızı temiz tutun, virgül içeren alanları tırnak içine alın ve sayıların metin olarak geldiğini unutmayın. Çevrimi hızlı ve gizlilik içinde yapmanız gerektiğinde, ücretsiz CSV’den JSON’a aracı bunu hiçbir şey yüklemeden tarayıcınızda yapar.