CSV'den SQL'e Dönüştürücü

Bu Araç Nedir?

Bir test veritabanını doldurmak, bir elektronik tablo dışa aktarımını bir tabloya yüklemek veya küçük bir veri kümesini taşımak genellikle aynı şekilde başlar: elinizde bir CSV dosyası vardır ve SQL'e ihtiyacınız olur. Bu araç CSV'nizi ayrıştırır (başlık satırını sütun adları olarak kullanarak) ve tüm veri satırlarını kapsayan tek bir INSERT INTO ifadesi oluşturur; bu ifade doğrudan bir veritabanı istemcisine yapıştırılmaya hazırdır.

Metin değerleri tek tırnak içine alınır; içteki tırnaklar iki katına çıkarılarak kaçış karakteriyle işlenir (böylece O'Brien, O''Brien haline gelir) — bu, MySQL, PostgreSQL ve SQLite'ın ortak kullandığı standart kaçış kuralıdır. Boş bir CSV hücresi, boş bir dize yerine SQL anahtar sözcüğü NULL olarak yazılır — bu bilinçli bir tercihtir, çünkü bir elektronik tablodaki boş hücre genellikle "değer yok" anlamına gelir, "boş bir metin parçası" anlamına gelmez ve çoğu şema bunun için NULL bekler.

Bir değerin tırnak içine alınıp alınmayacağına, gerçek bir tür çıkarımı değil, basit bir sezgisel yöntemle karar verilir: boşlukları kırpılmış hücre, sade bir tam sayı veya ondalık sayı gibi görünüyorsa (isteğe bağlı olarak başında bir eksi işareti bulunabilir), tırnaksız yazılır; geri kalan her şey — sayıya benzeyen ama fazladan karakter içeren, örneğin başında sıfır bulunan posta kodları gibi değerler dahil — metin olarak tırnak içine alınır. Bu, çıktının dürüst kalmasını sağlar: küçük bir içe aktarma için iyi bir başlangıç noktasıdır, ancak çalıştırmadan önce verilerinizi gerçek tablo şemanıza göre doğrulamanın yerini tutmaz.

Kaynak: CSV ayrıştırma, resmi bir CSV standardına en yakın şey olan RFC 4180'i izler; dize kaçışı için tek tırnağın iki katına çıkarılması, MySQL, PostgreSQL ve SQLite tarafından belgelenen ortak kuraldır.

Neden Kullanmalısınız?

• Özelleştirilebilir tablo adı — bir kez ayarlayın, her satır o tabloyu hedefler.
• Doğru dize kaçış işlemi — değerlerin içindeki tek tırnaklar iki katına çıkarılır, böylece SQL bozulmaz veya kesilmez.
• Öngörülebilir NULL işleme — boş hücreler, çoğu veritabanının eksik verileri ayırt etme biçimiyle uyumlu olarak boş dize yerine NULL olur.
• Yaygın SQL sözdizimi — burada oluşturulan INSERT INTO ... VALUES ... ifadesi MySQL, PostgreSQL ve SQLite'ta değişiklik yapılmadan çalışır.
• %100 istemci tarafında — CSV verileriniz (müşteri kayıtları veya işletme verileri içerebilir) tarayıcınızda ayrıştırılır ve dönüştürülür, hiçbir yere yüklenmez.

Nasıl Kullanılır

1. Başlık satırı içeren CSV verisini yapıştırın, örneğin: name,age\nAlice,30\nBob,25.
2. Hedef tablo adını girin (varsayılan my_table).
3. "SQL Oluştur" düğmesine tıklayın.
4. INSERT INTO ifadesini kopyalayın veya .sql dosyası olarak indirin, ardından veritabanınıza karşı çalıştırın.

Örnek

Giriş

name,age,city
Alice,30,
Bob,,NYC

Çıkış

INSERT INTO `my_table` (`name`, `age`, `city`)
VALUES
  ('Alice', 30, NULL),
  ('Bob', NULL, 'NYC');

Boş hücrelerin NULL haline geldiğine (boş dize değil) ve sayıya benzeyen age değeri 30'un tırnaksız kaldığına, her metin değerinin ise tırnak içine alındığına dikkat edin.

Pratik ipuçları

• Yerel bir test veritabanını doldurmak: bir elektronik tablodan küçük bir örneği CSV olarak dışa aktarın, burada dönüştürün ve INSERT ifadesini geliştirme veritabanınıza karşı çalıştırın.
• Oluşturulan SQL'i gerçek bir tabloya karşı çalıştırmadan önce her zaman sütun türlerini gözden geçirin — bu araç, sayısal mı metin mi olduğunu gerçek şemanıza göre değil basit bir sezgisel yönteme göre çıkarır, bu yüzden belirli bir biçim bekleyen bir tam sayı sütunu manuel ayarlama gerektirebilir.
• Binlerce satırınız varsa, bu aracın oluşturduğu tek bir çok satırlı INSERT ifadesi yine de geçerli SQL'dir, ancak çok büyük ifadeler bir veritabanının maksimum paket boyutunu aşabilir — bu sınıra takılırsanız önce CSV'yi daha küçük gruplara bölün.

Neden NULL, boş dize değil

CSV'den SQL'e elle betik yazarken yapılan yaygın bir hata, eksik her hücreyi boş bir dize '' olarak ele almaktır. Bu teknik olarak geçerli SQL'dir, ancak genellikle istediğiniz anlama gelmez: tam sayı olarak tanımlanan bir sütun ''yi kesinlikle reddedecektir ve bir metin sütununda bile, '' çoğu şema tasarımında ve raporlama sorgularında "bu değeri bilmiyoruz"dan farklı bir şey ifade eder (bir WHERE sütun IS NULL kontrolü boş dizelerle eşleşmez, tersi de geçerlidir). Boş hücreler için NULL kullanmak, çoğu veritabanının ve ORM'nin beklediği anlamla örtüşür ve bazı satırlarda sayısal bir sütunda eksik değerler olduğunda tür hatalarını önler.

Sıkça Sorulan Sorular