كيفية استخدام منسّق JSON Lines
- الصق إما مصفوفة JSON أو محتوى JSON Lines.
- اترك الاتجاه على «اكتشاف تلقائي» (Auto-detect) أو اختر اتجاهاً صراحةً.
- انسخ الناتج المحوَّل أو نزّله.
مزايا منسّق JSON Lines
- تقسيم مصفوفة JSON إلى مستند JSON مضغوط واحد في كل سطر
- جمع أسطر JSON Lines مجدداً في مصفوفة منسّقة
- اكتشاف الاتجاه تلقائياً، أو فرضه صراحةً
- الإبلاغ عن أول سطر غير صالح مع رقمه عند الجمع
- تخطي الأسطر الفارغة بأمان
- التنزيل كملف JSONL أو JSON
مثال على منسّق JSON Lines
من مصفوفة إلى JSON Lines
الإدخال:
[{"id":1,"level":"info"},{"id":2,"level":"error"}]النتيجة:
{"id":1,"level":"info"}
{"id":2,"level":"error"}الأسئلة الشائعة حول منسّق JSON Lines
ما صيغة JSON Lines / NDJSON؟
صيغة نصية تحتوي على قيمة JSON واحدة بالضبط في كل سطر، مفصولة بأسطر جديدة. وهي مناسبة للتدفق (streaming) وتُستخدم في أدوات شحن السجلات وBigQuery وواجهات Elasticsearch الجماعية والعديد من خطوط أنابيب البيانات.
كيف يحدد الاكتشاف التلقائي الاتجاه؟
إذا كان كل سطر من الأسطر الأولى يُحلَّل كقيمة JSON مستقلة، يُعامل الإدخال كـ JSON Lines ويُجمع في مصفوفة؛ وإلا فيُحلَّل كمستند JSON ويُقسَّم إلى أسطر.
ماذا لو كانت مصفوفتي تحتوي على مصفوفات أو كائنات متداخلة؟
يُكتب كل عنصر في المستوى الأعلى في سطر مستقل كـ JSON مضغوط، بغضّ النظر عن عمق تداخله.
هل تسبب الأسطر الفارغة مشكلة؟
تُتخطى الأسطر الفارغة عند الجمع. وعند التقسيم لا يحتوي الناتج أبداً على أسطر فارغة، لذا فهو آمن لمستهلكي NDJSON الصارمين.