محول CSV
حوّل صفوف CSV إلى نص TSV أو جدول Markdown مع فحص الفواصل والاقتباسات والقيم الفارغة والمحارف المؤثرة في الناتج.
حوّل نص CSV إلى صيغة أخرى
يفيد CSV في التبادل، لكن قد يحتاج مسار آخر إلى قيم مفصولة بعلامات تبويب أو جدول Markdown. يعرض هذا المحول نصاً محولاً لتفحص الفاصل والاقتباسات والقيم الفارغة وشكل الصف قبل نسخه.
يغيّر التحويل التمثيل ولا ينظف البيانات أو يتحقق من schema أو يستنتج الأنواع أو يضمن أن كل أداة لاحقة ستقرأ الناتج كما تقصد. احتفظ بـ CSV الأصلي وراجع الناتج.
استخدم عينات فيها عنوان وقيمة فارغة وفاصل مقتبس وقيمة حساسة لـ Markdown عندما تظهر في المصدر، وافحص الإدخال والناتج جنباً إلى جنب.
ماذا يفعل تحويل CSV
يقرأ المحول السجلات المفصولة ويكتبها بفاصل أو صياغة أخرى. يستخدم TSV علامات تبويب، بينما يستخدم جدول Markdown أعمدة pipe وصف فصل.
يجب تفسير الاقتباسات وعمليات الهروب قبل الإخراج. لا ينبغي أن تصبح الفاصلة المحمية داخل CSV عمود TSV جديداً، وقد تحتاج pipe أو newline إلى هروب في Markdown.
الناتج نص للصيغة المستهدفة وليس ترحيل schema أو استيراد قاعدة بيانات أو تحويل أنواع أو دليلاً على اكتمال الصفوف.
كيفية تحويل CSV
- ألصق عينة CSV كاملة وتأكد من الفاصل ونمط الاقتباس.
- اختر الصيغة المستهدفة مثل TSV أو جدول Markdown إذا كان الخيار متاحاً.
- افحص العناوين والخلايا الفارغة والفواصل المقتبسة وعلامات tab وpipe والأسطر والصفوف غير المتساوية.
- قارن حقولاً مختارة بـ CSV الخام وشغّل importer أو renderer المطلوب للمشروع.
- أزل الأسرار والمعلومات الشخصية قبل مشاركة النص المحول.
طريقة التحويل
- تحليل حقول المصدر
يقرأ الأداة صفوف CSV والفواصل والاقتباسات والقيم الفارغة وحدود الأسطر وفق مسار الإدخال.
- اختيار صيغة الهدف
يوضع كل حقل في تخطيط الصيغة المختارة مثل أعمدة tab أو خلايا Markdown.
- هروب محارف الهدف
قد تحتاج المحارف ذات المعنى في الصيغة المستهدفة إلى اقتباس أو هروب. راجع الناتج عند وجود pipe أو tab أو quote أو newline.
يجب تأكيد هروب محارف الهدف وخيارات الفاصل والترميز والحقول متعددة الأسطر والتعامل مع الصفوف التالفة بمحرك حي.
قراءة الناتج المحول
النتيجة الناجحة تستخدم الصيغة المستهدفة مع الاحتفاظ بترتيب وقيم الحقول. قارن الخلايا المهمة بالأصل.
الأعمدة المفقودة أو الزائدة أو فواصل Markdown التالفة تشير إلى مشكلة في الفاصل أو الاقتباس أو الهروب وتحتاج مراجعة.
إذا رفض importer أو renderer الناتج، فافحص dialect وschema الخاصة بهما. التحويل ليس تحققاً.
أخطاء شائعة
افتراض أن فاصلة CSV وpipe في Markdown تحملان المعنى نفسه قد ينشئ خلايا إضافية.
حذف الحقول الفارغة يغير مواضع الأعمدة وقد يفسد السجلات.
نسخ الناتج دون فحص tabs ونهايات الأسطر وpipe المهربة قد يغير نتيجة الهدف.
اعتبار التحويل تنظيفاً قد يخفي صفوف المصدر التالفة أو القيم الحساسة.
القيود
القدرة الموثقة هي تحويل النص بين CSV وصيغة مستهدفة. لا تضمن صحة schema أو تنظيف البيانات أو استنتاج الأنواع أو إصلاح الترميز أو توافق الاستيراد.
يجب اختبار dialect والحقول متعددة الأسطر والصفوف التالفة وهروب Markdown والملفات الكبيرة في المسار الحقيقي.
لا تحوّل بيانات إنتاج سرية للمشاركة ما لم تسمح السياسة بذلك.
Examples
تحويل CSV إلى TSV
تحويل CSV إلى TSV
أرسل CSV واختر الصيغة المستهدفة ثم راجع الحقول الناتجة.
استُبدل فاصل الفاصلة بعلامة tab بين الحقلين.
تحويل CSV إلى Markdown
تحويل CSV إلى Markdown
أرسل CSV واختر الصيغة المستهدفة ثم راجع الحقول الناتجة.
أضيفت خلايا pipe وصف فصل Markdown.
الحفاظ على قيمة فارغة
الحفاظ على قيمة فارغة
أرسل CSV واختر الصيغة المستهدفة ثم راجع الحقول الناتجة.
بقي الحقل الفارغ بين الحقلين الأول والثالث.
الحفاظ على فاصلة مقتبسة
الحفاظ على فاصلة مقتبسة
أرسل CSV واختر الصيغة المستهدفة ثم راجع الحقول الناتجة.
بقيت الفاصلة داخل حقل الاسم ولم تنشئ عموداً جديداً.
هروب pipe في Markdown
هروب pipe في Markdown
أرسل CSV واختر الصيغة المستهدفة ثم راجع الحقول الناتجة.
هُربت pipe حتى تبقى داخل خلية Markdown.
مقارنة صفوف غير متساوية
مقارنة صفوف غير متساوية
أرسل CSV واختر الصيغة المستهدفة ثم راجع الحقول الناتجة.
بقي الحقل الزائد ظاهراً كاختلاف في طول الصف.
Frequently asked questions
هل يتحقق التحويل من CSV؟
لا. يغيّر التمثيل فقط. استخدم parser وschema validator وimporter المطلوب.
هل يبقى ترتيب الأعمدة؟
المفترض أن يحافظ على ترتيب المصدر؛ قارن الناتج بـ CSV الخام عندما يكون الترتيب مهماً.
كيف تمثل الحقول الفارغة؟
تبقى في مواضعها في الصيغة الهدف، لكن قد يفسرها المستهلك كفراغ أو null وفق عقده.
هل تبقى الفواصل المقتبسة؟
تُقرأ الفاصلة المقتبسة كمحتوى حقل قبل كتابة فاصل الصيغة الهدف.
لماذا يتم هروب pipe في Markdown؟
لأن pipe تفصل خلايا Markdown، لذلك تحتاج قيمة pipe داخل البيانات إلى هروب.
هل يمكن تحويل CSV إلى TSV؟
نعم، إذا حُلّل الإدخال بفاصله الصحيح واستخدم الهدف علامات tab. افحص tabs لا المسافات.
هل يصلح التحويل الصفوف التالفة؟
لا تفترض الإصلاح. أصلح المصدر ثم تحقق من الصيغتين بالأدوات الفعلية.
ماذا أفعل بعد التحويل؟
راجع diff واعرض أو استورد النص الهدف وتحقق من القيم المهمة وأزل البيانات الحساسة.