Validasi file CSV

Cara memvalidasi file CSV

1. Buka file .csv, .tsv, atau .txt. Pemisah dan BOM UTF-8 atau UTF-16 dikenali otomatis; jika kolomnya tampak keliru, pilih pemisah lain atau pengodean lama di pengaturan impor.
2. Jika perlu, isi jumlah kolom yang wajib dimiliki setiap baris data. Jika dibiarkan kosong, dipakai jumlah kolom di baris judul.
3. Jika perlu, tambahkan aturan untuk kolom yang penting bagi Anda: tipe data, apakah nilai wajib diisi atau harus unik, nilai yang diizinkan, nilai minimum dan maksimum, rentang panjang, atau pola.
4. Jalankan pemeriksaan dan telusuri laporannya: galat lebih dulu, lalu peringatan. Perbaiki nilainya di editor CSV atau rapikan dengan Bersihkan data CSV, lalu validasi ulang.

Untuk melihat tipe, sel kosong, dan nilai unik setiap kolom sebelum menulis aturan, periksa file dengan profil kolom.

Pemeriksaan struktur pada setiap baris data

Nilai bertanda kutip yang tidak pernah ditutup menghentikan pemeriksaan dengan galat yang menyebut baris data tempat nilai itu dimulai, karena sisa file tidak lagi bisa dipecah menjadi baris data dengan andal.

Aturan kolom: tipe, wajib diisi, unik, dan pola

Aturan berlaku untuk kolom yang judulnya sama persis dengan nama aturan; aturan untuk kolom yang tidak ada di file dilewati. Aturan bisa disimpan sebagai file JSON Table Schema dan dimuat lagi untuk ekspor berikutnya; tipe dan kunci yang tidak dikenal dalam skema yang dimuat akan diabaikan.

Membaca laporan

• Nomor baris menghitung baris data setelah baris judul kolom (baris judul adalah baris 0). Nilai dengan baris baru di dalam tanda kutip tetap dihitung satu baris data, jadi nomor baris bisa berbeda dari nomor baris di editor teks.
• Setiap masalah menyebutkan kolomnya dan mengutip nilainya, sehingga Anda bisa mencarinya di penampil CSV atau di editor.
• Galat merusak struktur atau melanggar aturan; peringatan menunjuk data yang sebenarnya CSV valid, tetapi sering menimbulkan masalah saat diimpor.
• Hingga 5.000 masalah dicantumkan. Selebihnya tetap dihitung per jenis masalah, dan daftarnya ditandai terpotong.

Batas dan privasi validasi

Validator membaca satu baris data dalam satu waktu, jadi file di atas batas interaktif 25 MB diperiksa dalam mode streaming di worker latar belakang, lengkap dengan progres dan opsi pembatalan. Dalam mode streaming, baris data yang field-nya lebih sedikit dari baris judul kolom saat ini dilengkapi dulu sebelum diperiksa, sehingga hanya baris data dengan field berlebih yang dilaporkan sebagai galat jumlah field.

Validasi berjalan di browser Anda. File CSV tidak diunggah ke server.

Contoh: memeriksa ekspor pendaftaran dengan empat aturan

Ekspor data pendaftaran diperiksa dengan empat aturan: id wajib diisi, unik, dan berupa bilangan bulat; email wajib diisi dan berformat email; signup_date berupa tanggal; plan hanya mengizinkan basic, pro, dan team. Hasilnya adalah laporan validator, satu masalah per baris setelah ringkasan: tanggal yang mustahil, email tanpa akhiran domain, Pro dengan huruf besar yang keliru, id yang berulang, email yang kosong, serta team dengan spasi di akhir, yang sekaligus memicu peringatan dan bukan nilai yang diizinkan.

id,email,signup_date,plan
1,ana@example.com,2024-02-30,pro
2,kim@example,2024-03-01,Pro
2,bao@example.com,2024-03-04,basic
4,,2024-03-05,team 

{"rows":4,"errors":6,"warnings":1,"truncated":false}
{"code":"type","row":1,"column":"signup_date","value":"2024-02-30","params":{"type":"date"}}
{"code":"format","row":2,"column":"email","value":"kim@example","params":{"format":"email"}}
{"code":"enum","row":2,"column":"plan","value":"Pro","params":{"allowed":"basic, pro, team"}}
{"code":"unique","row":3,"column":"id","value":"2","params":{"first":2}}
{"code":"whitespace","row":4,"column":"plan","value":"team ","params":{}}
{"code":"required","row":4,"column":"email","value":"","params":{}}
{"code":"enum","row":4,"column":"plan","value":"team ","params":{"allowed":"basic, pro, team"}}