ما هو JSON Lines؟
JSON Lines (ويُسمى أيضاً NDJSON) صيغة نصية يكون فيها كل سطر قيمة JSON واحدة كاملة، عادة كائناً، تفصلها أسطر جديدة دون مصفوفة محيطة. ولأن القارئ يستطيع معالجة سطر واحد في كل مرة، تناسب السجلات والتصديرات وواجهات البث حيث كان لا بد من الاحتفاظ بمصفوفة JSON واحدة كاملة في الذاكرة؛ والثمن أن الملف ككل ليس JSON صالحاً وأن كل سطر يجب تحليله على حدة.
كيفية استخدام مدقّق JSON Lines
- الصق محتوى NDJSON / JSON Lines.
- اقرأ الملخص وجدول الأسطر غير الصالحة.
- أصلح الأسطر المبلَّغ عنها وأعد التشغيل قبل استيراد الملف.
مزايا مدقّق JSON Lines
- فحص كل سطر كقيمة JSON مستقلة
- رقم السطر والعمود بدقة لكل خطأ مع تلميح للإصلاح
- تمييز الأسطر الفارغة مع أرقامها
- إحصاء السجلات الصالحة والتنبيه عند اختلاط أنواع السجلات
- تحقق فوري أثناء اللصق
- جدول الأخطاء قابل للتصدير بصيغة CSV
مثال على مدقّق JSON Lines
اكتشاف سطر معطوب في تصدير سجلات
الإدخال:
{"id":1,"event":"signup"}
{"id":2,"event":"login",}
{"id":3}النتيجة:
Line 2, column 25 — Invalid JSON. Trailing commas are not allowed before } or ].الأسئلة الشائعة حول مدقّق JSON Lines
ما الذي يتم فحصه بالضبط؟
يجب أن يكون كل سطر غير فارغ قيمة JSON كاملة وصالحة. ويُبلَّغ عن كل سطر فاشل مع رقمه والعمود ورسالة المحلّل وتلميح؛ وتُميَّز الأسطر الفارغة بشكل منفصل.
هل الأسطر الفارغة غير صالحة؟
ترفضها محلّلات NDJSON الصارمة، لذا يُبلَّغ عنها كتحذير مع أرقام أسطرها حتى لو كان باقي الملف صالحاً.
هل يهم إن كانت الأسطر كائنات أو مصفوفات؟
يُسمح بأي قيمة JSON في كل سطر، لكن معظم المستهلكين يتوقعون كائناً واحداً في كل سطر. ويظهر تحذير عند اختلاط أنواع السجلات.
هل يمكنني تصدير قائمة الأخطاء؟
نعم — يمكن نسخ جدول الأسطر غير الصالحة أو تنزيله بصيغة CSV لإرفاقه بتقرير خطأ أو تذكرة جودة بيانات.
المراجع
- JSON Linesاتفاقية JSON Lines: قيمة JSON كاملة في كل سطر، بترميز UTF-8 وفواصل "\n" وامتداد .jsonl.
- RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Formatقواعد JSON: الكائنات والمصفوفات والنصوص والأرقام والقيم الثلاث الثابتة، وUTF-8 كترميز للتبادل.