CSV’yi YAML’a dönüştürün

CSV, YAML’a nasıl dönüştürülür?

1. Dosya aç düğmesini seçin, araca bir .csv, .tsv veya .txt dosyası sürükleyin ya da Yapıştır seçeneğini kullanın. Anahtarlar yanlış görünüyorsa ayırıcıyı ve kodlamayı İçeri aktarma ayarları altından kontrol edin.
2. Değer türleri ve Boş hücreler ayarlarını seçin. YAML sekmesi, indirilecek metnin birebir aynısını gösterir.
3. Girinti seçin, ardından Kopyala veya YAML indir seçeneğini kullanın.

Sonuç, üst düzeyde bir dizidir (- key: value öğeleri); test verisi (fixture), başlangıç verisi (seed) ve statik site veri dosyalarında kullanılan yapı budur. Bunun yerine JSON gerekiyorsa CSV’den JSON’a aracında aynı tür seçenekleri bulunur.

YAML çıktı seçenekleri

Belirsiz değerler nasıl tırnaklanır?

Çıktı, hem YAML 1.2 ayrıştırıcılarında hem de daha fazla sözcüğü mantıksal değer ve sayı sayan PyYAML gibi eski YAML 1.1 ayrıştırıcılarında aynı şekilde geri okunacak biçimde yazılır.

• Ülke ve cevap kodları: NO, yes, off, y ve on tırnaklanır; böylece Norveç’in kodu false olarak yüklenmez. Bu anahtarlar için de geçerlidir ("on": x).
• Baştaki sıfırlar: 0150 ve 08001 tırnaklanır; tırnaksız olduklarında YAML 1.1 bunları sekizlik veya onluk sayı olarak okur ve sıfırı atar.
• Metin modunda tarihler ve sayılar: 2019-04-01 ve 12 tırnaklanır; böylece zaman damgası veya tam sayı olarak yüklenmezler.
• Null’a benzeyen metin: null veya ~ içeren bir hücre tırnaklanır; böylece yazdığınız metin olarak kalır ve boş bir hücreyle karışmaz.
• Bir değerin içindeki satır sonları |- düz blok (literal block) olur; metin içindeki : veya # tırnaklanır. Uzun satırlar hiçbir zaman katlanmaz.
• Başlıklar, boşluklar ve Latin dışı yazı sistemleri dahil, yazıldıkları gibi anahtar olarak kullanılır; sipariş_no gibi Türkçe karakterli başlıklar da değişmez. Boş bir başlık Column 3, yinelenen bir başlık name (2) olur.

CSV’den YAML’a dönüştürmede sık görülen sorunlar

• Sayıları ve true/false değerlerini algıla açıkken bir sayı sütunu tırnaklı kaldı. En az bir değer sade bir sayı değil; örneğin 1,5, 12 kg veya 007. Bunu CSV görüntüleyicide bulun.
• Evet/hayır sütunu mantıksal değere dönüşmedi. Yalnızca true ve false dönüştürülür; çünkü yes, no ve on yalnızca YAML 1.1’de mantıksal değer anlamına gelir. Mantıksal değer gerekiyorsa bunları önce CSV’de değiştirin; örneğin CSV düzenleyicideki metin değiştirme aracıyla.
• Anahtarlarda ü, ç gibi tuhaf karakterler var. Dosya UTF-8 değil. İçeri aktarma ayarları altında dosyanın kodlamasını seçin (eski Türkçe Excel dosyalarında genellikle Windows-1254).
• Her şey tek bir anahtarın altında. Ayırıcı yanlış tahmin edilmiş; ayırıcıyı İçeri aktarma ayarları altından belirleyin.

Sınırlar ve gizlilik

25 MB, 100.000 satır veya 2 milyon hücreye kadar dosyalar, ilk 200 satırın canlı önizlemesiyle açılır. Daha büyük dosyalar akış modunda dönüştürülür: dosya parçalar hâlinde iki kez okunur (bir kez sütunları ve türlerini ölçmek, bir kez de yazmak için), bir bildirim indirilen dosyanın tüm dosyayı kapsadığını söyler ve Kopyala sunulmaz. Tek bir çıktı dosyası en fazla 4 GB olabilir.

Dönüştürme bu sekmede arka plandaki bir işçide çalışır; böylece sayfa yanıt vermeye devam eder ve İptal işlemi durdurur. CSV hiçbir zaman bir sunucuya gönderilmez.

Örnek: ülke kodları ve posta kodları içeren bir müşteri listesi

Ülke kodları, baştaki sıfırlı posta kodları, yes/no bayrakları, tarihler ve boş hücreler içeren bir müşteri listesi, varsayılan ayarlarla (tümü metin, boş hücreler null) dönüştürüldü. Sayıları ve true/false değerlerini algıla seçildiğinde yalnızca orders değişir ve 12, 3 ve 7 olur.

country,code,postcode,vat_registered,since,orders
Norway,NO,0150,yes,2019-04-01,12
Spain,ES,08001,no,2021-11-15,3
United States,US,02134,,,7

- country: Norway
  code: "NO"
  postcode: "0150"
  vat_registered: "yes"
  since: "2019-04-01"
  orders: "12"
- country: Spain
  code: ES
  postcode: "08001"
  vat_registered: "no"
  since: "2021-11-15"
  orders: "3"
- country: United States
  code: US
  postcode: "02134"
  vat_registered: null
  since: null
  orders: "7"