مدقق CSV

مدقق CSV

تم تحميل الملف:

قد يفتح ملف CSV بسلاسة في جدول بيانات ثم يفشل عند استيراده إلى قاعدة بيانات أو رفعه عبر واجهة API. يقرأ هذا المدقق الملف كما يصفه المعيار RFC 4180 ويعرض كل مشكلة في البنية مع رقم السطر: علامات اقتباس لا تُغلق، وصفوف بعدد أعمدة خاطئ، وأسماء عناوين فارغة أو مكررة، وعلامة ترتيب البايت (BOM) في بداية الملف، وفواصل زائدة في نهاية الصف. الصق النص أو اختر ملفًا، ثم حدد الفاصل (أو اترك الأداة تكتشفه) واقرأ التقرير.

كيف تتحقق من ملف CSV

  1. 1

    الصق ملف CSV أو ارفعه

    الصق النص في المربع، أو اختر ملفًا بصيغة .csv أو .tsv أو .txt. تُقبل الملفات حتى 1,000,000 حرف.

  2. 2

    اختر الفاصل وصف العناوين

    اترك الفاصل على الاكتشاف التلقائي أو فرض الفاصلة أو الفاصلة المنقوطة أو علامة الجدولة أو الخط العمودي. وحدد ما إذا كان الصف الأول يحمل أسماء الأعمدة.

  3. 3

    اقرأ التقرير

    تُعرض كل مشكلة مع رقم سطرها ووصف بسيط، وتُصنف كخطأ أو تحذير. انسخ التقرير لمشاركته.

  4. 4

    صحح ثم افحص من جديد

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

ما الذي يفحصه المدقق

المعيار RFC 4180 هو أقرب ما لدى CSV إلى مواصفة رسمية. فهو ينص على أن السجلات تُفصل بفواصل أسطر، وأن الحقول التي تحتوي على فاصل أو علامة اقتباس أو فاصل أسطر يجب أن توضع بين علامتي اقتباس مزدوجتين، وأن علامة الاقتباس داخل حقل مقتبس تُكتب مرتين (""). يطبق المدقق هذه القواعد على نصك، ثم يضيف بعض الفحوص المهمة عمليًا.

الفحوص وكيفية الإبلاغ عنها

الفحص الخطورة ما الذي يطلقه
علامة اقتباس غير متوازنة خطأ يُفتح حقل مقتبس وينتهي الملف قبل إغلاقه. السطر المعروض هو السطر الذي فُتحت فيه علامة الاقتباس.
علامة اقتباس داخل حقل غير مقتبس خطأ وجود " في منتصف حقل لا يبدأ بعلامة اقتباس، مثل 5" pipe.
نص بعد علامة الاقتباس الختامية خطأ يأتي بعد علامة الاقتباس الختامية شيء غير الفاصل أو نهاية السطر، مثل "abc"def.
عدد الأعمدة خطأ يحتوي الصف على حقول أكثر أو أقل من الصف الأول.
اسم عنوان فارغ خطأ اسم عمود في صف العناوين فارغ.
اسم عنوان مكرر خطأ يتشارك عمودان الاسم نفسه بعد تجاهل المسافات وحالة الأحرف (Name و name).
علامة ترتيب البايت تحذير يبدأ الملف بالحرف الخفي U+FEFF.
فاصل زائد في النهاية تحذير ينتهي الصف بفاصل، فيصبح فيه عمود فارغ إضافي.
سطر فارغ تحذير سطر فارغ بين السجلات.

الفواصل

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

أرقام الأسطر

تُحسب أرقام الأسطر وفق الأسطر الفعلية في النص الذي قدمته، بدءًا من 1. الحقل المقتبس الذي يحتوي على فواصل أسطر يمتد على عدة أسطر فعلية؛ وتُعرض المشكلة في ذلك السجل على السطر الذي يبدأ فيه السجل.

أسباب شائعة لأخطاء CSV

  • تصدير من جدول بيانات يضيف علامة BOM، وتقرؤها بعض أدوات الاستيراد جزءًا من اسم العمود الأول.
  • عمود نص حر يحتوي على فواصل أو علامات اقتباس لم يضعها سكربت التصدير بين علامتي اقتباس.
  • دمج ملفات بأعداد أعمدة مختلفة.
  • فاصلة زائدة في النهاية يضيفها سكربت يكتب كل قيمة متبوعة بفاصل.

الأسئلة الشائعة

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

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

لا. إنه يفحص بنية الملف: الاقتباس والفواصل وعدد الأعمدة وأسماء العناوين وعلامة ترتيب البايت والأسطر الفارغة. ولا يتحقق من كون القيمة رقمًا أو تاريخًا أو بريدًا إلكترونيًا صحيحًا، ويقرأ النص بترميز UTF-8.

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

أدوات ذات صلة

الأداة متاحة بلغات أخرى