التحقق من ملف CSV

طريقة التحقق من ملف CSV

1. افتح ملف ⁦.csv⁩ أو ⁦.tsv⁩ أو ⁦.txt⁩. يُكتشف المحدِّد وعلامة ترتيب البايت لـ⁦UTF-8⁩ أو ⁦UTF-16⁩؛ وإذا بدت الأعمدة خاطئة يمكن اختيار محدِّد آخر أو ترميز قديم من إعدادات الاستيراد.
2. يمكن اختياريًا إدخال عدد الأعمدة الذي يجب أن يكون في كل سجل. وإذا تُرك فارغًا يُعتمد عدد أعمدة صف العناوين.
3. يمكن اختياريًا إضافة قواعد للأعمدة المهمة: النوع، وهل القيمة مطلوبة أو يجب أن تكون فريدة، والقيم المسموح بها، والحد الأدنى والأقصى، ونطاق الطول، أو نمط.
4. شغّل الفحص وراجع التقرير: الأخطاء أولًا ثم التحذيرات. أصلِح القيم في محرر CSV أو رتّبها بأداة تنظيف CSV، ثم أعِد التحقق.

لمعرفة أنواع كل عمود وقيمه الفارغة والمميزة قبل كتابة القواعد، استخدم الوصف الإحصائي للملف في تحليل CSV.

فحوص البنية

القيمة المفتوحة بعلامة اقتباس التي لا تُغلق أبدًا توقف الفحص برسالة خطأ تذكر السجل الذي تبدأ فيه، لأن باقي الملف لا يمكن تقسيمه إلى سجلات بشكل موثوق.

قواعد الأعمدة

تنطبق القاعدة على العمود الذي يطابق عنوانه اسمها تمامًا؛ وتُتخطّى قواعد الأعمدة غير الموجودة في الملف. ويمكن حفظ القواعد في ملف JSON بصيغة Table Schema وتحميلها مرة أخرى للتصدير التالي؛ وتُتجاهَل الأنواع والمفاتيح غير المعروفة في المخطط المحمَّل.

قراءة التقرير

• تعدّ أرقام الصفوف سجلات البيانات بعد صف العناوين (صف العناوين هو الصف 0). والقيمة التي فيها فاصل سطر داخل علامات اقتباس تبقى سجلًا واحدًا، لذا قد يختلف رقم الصف عن رقم السطر في محرر النصوص.
• تذكر كل مشكلة عمودها وتقتبس قيمتها، فيمكن البحث عنها في عارض CSV أو في المحرر.
• الأخطاء تكسر البنية أو قاعدة ما؛ أما التحذيرات فتشير إلى بيانات صالحة من حيث CSV لكنها كثيرًا ما تسبب مشكلات عند الاستيراد.
• تُدرج 5 آلاف مشكلة على الأكثر. وبعد ذلك يستمر عدّ الإجمالي لكل نوع من المشكلات، وتُوسم القائمة بأنها مقتطعة.

الحدود والخصوصية

يقرأ المدقق سجلًا واحدًا في كل مرة، لذا تُفحص الملفات التي تتجاوز الحد التفاعلي البالغ 25 ميغابايت تدفقيًا في عامل خلفي، مع عرض التقدم وإمكانية الإلغاء. وفي الوضع التدفقي تُكمَّل حاليًا السجلات التي فيها حقول أقل من صف العناوين قبل الفحص، فلا يُبلَّغ عن خطأ عدد الحقول إلا للسجلات التي فيها حقول زائدة.

يجري التحقق في متصفحك، ولا يُرفع ملف CSV إلى أي خادم.

مثال

ملف تسجيلات مُصدَّر فُحص بأربع قواعد: id عدد صحيح مطلوب وفريد؛ وemail نص مطلوب بتنسيق بريد إلكتروني؛ وsignup_date تاريخ؛ وplan يقبل ⁦basic⁩ و⁦pro⁩ و⁦team⁩. الناتج تقرير المدقق، مشكلة في كل سطر بعد الملخص: تاريخ مستحيل، وبريد بلا لاحقة نطاق، و⁦Pro⁩ بحالة أحرف خاطئة، ومعرّف مكرر، وبريد مفقود، و⁦team ⁩ بمسافة في آخرها، وهي تحذير وقيمة غير مسموح بها في آن واحد.

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"}}