مدقق CSV
اعثر على الصفوف المعطوبة في ملف CSV قبل استيراده إلى قاعدة بيانات أو جدول بيانات أو نظام متجر. تحلل الأداة البيانات وفق قواعد الاقتباس القياسية في CSV، وتكتشف الفاصل أو تستخدم الفاصل الذي تختاره، وتتحقق من أن لكل صف العدد نفسه من الأعمدة، وأن علامات الاقتباس مغلقة، وأن النص بترميز UTF-8 سليم. وتعرض الفاصل ونهايات الأسطر وعدد الصفوف والأعمدة والعناوين الفارغة أو المكررة والصفوف التي تحتاج إلى إصلاح.
الأسئلة الشائعة
ما الذي يتحقق منه مدقق CSV؟
يتحقق من أن لكل صف عدد أعمدة يساوي عدد أعمدة الصف الأول، وأن كل حقل موضوع بين علامتي اقتباس مغلق، وأن علامات الاقتباس لا تُستخدم إلا وفق ما يسمح به CSV. كما يبحث عن مؤشرات على ترميز خاطئ، ومحارف NUL، وعناوين فارغة أو مكررة، ونهايات أسطر مختلطة. تجعل الأخطاء الملف غير صالح، بينما تُدرج التحذيرات للمراجعة.
كيف يجري اكتشاف الفاصل؟
عند اختيار «اكتشاف تلقائي»، يجرب المدقق الفاصلة والفاصلة المنقوطة وعلامة الجدولة والشرطة العمودية، ثم يختار ما يقسم الصفوف بأكبر قدر من الاتساق. إذا كان الملف يستخدم فاصلًا يظهر أيضًا في القيم، فاختره صراحةً في حقل «الفاصل». وتعرض النتيجة دائمًا الفاصل المستخدم.
كيف يُبلّغ عن الصفوف ذات العدد الخاطئ من الأعمدة؟
تُقارن كل الصفوف بالصف الأول، ويُدرج كل صف مختلف مع رقمه وعدد أعمدته والعدد المتوقع. يبدأ ترقيم الصفوف من 1، بما في ذلك صف العناوين، وتُدرج أول 20 صفًا مختلفًا مع عدد بقية الصفوف. ولا تؤدي فواصل الأسطر الموضوعة بين علامتي اقتباس داخل حقل إلى بدء صف جديد.
ما مشكلات الاقتباس التي يجري اكتشافها؟
يجب أن ينتهي الحقل الذي يبدأ بعلامة اقتباس مزدوجة بعلامة اقتباس مماثلة، ويجب تكرار علامة الاقتباس داخل الحقل المحاط بعلامتي اقتباس على هيئة "". يُبلغ المدقّق عن الحقول المحاطة بعلامات اقتباس التي لم تُغلق مطلقًا، وعن علامات الاقتباس التي تظهر في منتصف حقل غير محاط بعلامات اقتباس. ويشيع كلا الأمرين عندما تُصدَّر قيمة تحتوي على المحدِّد من دون إحاطتها بعلامات اقتباس على النحو الصحيح.
كيف يتحقق من الترميز؟
يحتوي النص المحفوظ بترميز آخر ثم المقروء على أنه UTF-8 على أحرف استبدال، ويعدّها المدقّق ويُبلغ عنها كخطأ. كما يُبلغ عن أحرف NUL، وهي علامة على أن الملف ثنائي أو بترميز UTF-16. يُسمح بعلامة ترتيب بايتات UTF-8، وتظهر في سطر الترميز.
ما عمليات التحقق من الترويسة المتاحة؟
عند تفعيل خيار «يحتوي الصف الأول على ترويسات»، تُدرج خلايا الترويسة الفارغة والترويسات المتكررة كتحذيرات، لأن كثيرًا من أدوات الاستيراد ترفضها. أوقف الخيار للملفات التي لا تحتوي على صف ترويسة. يُجرى التحقق من عدد الأعمدة في الحالتين.
لماذا يُبلغ عن نهايات الأسطر؟
تُظهر النتيجة ما إذا كان الملف يستخدم نهايات أسطر LF أو CRLF أو CR. ويصدر تحذير إذا مزج الملف بينها، لأن بعض أدوات الاستيراد تحسب الصفوف بطرق مختلفة في هذه الحالة. فواصل الأسطر داخل الحقول المحاطة بعلامات اقتباس جزء من القيمة ومسموح بها.
هل تمثل الأسطر الفارغة مشكلة؟
يتم تخطي الأسطر الفارغة أو التي لا تحتوي إلا على مسافات بيضاء، ولا تُحتسب كصفوف. أما صف الحقول الفارغة مثل ,,, فهو صف حقيقي ويجب أن يحتوي على العدد الصحيح من الأعمدة.
ما الفرق بين الأخطاء والتحذيرات؟
الأخطاء هي مشكلات تجعل البيانات غير موثوقة، مثل الصفوف غير المتساوية أو علامات الاقتباس غير السليمة أو الترميز الخاطئ، وتؤدي إلى اعتبار الملف غير صالح. تشير التحذيرات إلى أمور مسموح بها CSV لكنها تسبب مشكلات غالبًا، مثل الترويسات المكررة أو نهايات الأسطر المختلطة. يُشار إلى الملف الذي لا يحتوي إلا على تحذيرات بأنه صالح.
ما الحد الأقصى لحجم CSV، وهل يمكنني تحويله؟
يمكن أن يصل حجم المدخلات إلى 5 MiB و100,000 صفًا. لتحويل CSV صالح إلى JSON أو YAML أو XLSX أو تنسيق آخر، استخدم محول تنسيق البيانات.