تحويل JSON إلى CSV

تسطيح شجرة في شبكة

JSON شجرة وCSV مستطيل، والتحويل كله هو مسألة كيف يصبح أحدهما الآخر. الحالة النظيفة هي مصفوفة كائنات تشترك كلها في المفاتيح نفسها — كل كائن صف، وكل مفتاح عمود، ولا يضيع شيء. وهكذا تبدو معظم استجابات API والملفات المُصدَّرة، ولهذا ينجح الأمر عادةً دون عناء. وكل ما هو صعب يأتي من مستندات ليست بهذا الشكل.

تُسطَّح الكائنات المتداخلة بضم مفاتيحها، فيصبح كائن العنوان داخل العميل أعمدة مثل address.city وaddress.postcode — وهو عُرف يتعامل معه كل برنامج جداول بيانات ولا يحدده أي معيار. والمفاتيح التي تظهر في بعض الكائنات دون غيرها تصبح أعمدة فارغة في الصفوف التي خلت منها، وهذه هي الإجابة الصحيحة: فالبديل هو حذف بيانات لا تحملها إلا بعض السجلات.

المصفوفات المتداخلة هي حيث تعجز الشبكة فعلًا عن المتابعة. فالسجل الواحد الذي يحتوي على ثلاثة بنود طلب هو صف واحد يحتوي على قائمة، لا ثلاثة صفوف — وتحويله إلى ثلاثة سيكرر كل حقل آخر ويغيّر معنى البيانات بصمت. لذا تُوسَّع مصفوفة كائنات واحدة إلى صفوف، وتُكتب أي مصفوفات أخرى في خليتها كنص. وإذا كان ما تحتاجه هو بنود الطلب لا الطلبات، فوجّه التحويل إلى تلك المصفوفة بدلًا من ذلك؛ فالشجرة التي تحتوي على قائمتين متجاورتين ليس لها مستطيل صحيح واحد، واختيار أحدها قرار لا يملكه إلا أنت.

وهناك تفصيلان يسببان المتاعب عند الإخراج. فالقيم التي تحتوي على فاصلة أو علامة اقتباس أو فاصل أسطر توضع بين علامتي اقتباس حتى تبقى سليمة — وهذا CSV صحيح لكنه يبدو غريبًا إذا فحصت الملف الخام. والمعرّف الرقمي الطويل يصبح خطرًا بمجرد وصول ملف CSV إلى برنامج جداول بيانات: إذ سيقرؤه Excel كرقم، ويقرّبه بعد خمسة عشر رقمًا، ويحذف أي صفر بادئ، وهذه مشكلة يسببها برنامج جداول البيانات لا التحويل.

عندما تحتاج إلى شيء آخر

jq هي الأداة المناسبة حين يحتاج الشكل إلى قرار لا إلى تخمين: يختار jq -r '.orders[] | [.id, .customer.name, .total] | @csv' الحقول التي تريدها بالضبط من المستوى الذي تريده بالضبط، وهذا هو التحكم الذي لا يستطيع المسطِّح التلقائي تقديمه. كما أنها تعمل كتدفق، فلا يعود حجم الملف عاملًا يُحسب له حساب.

وللبيانات المتداخلة عمومًا، يمنحك Miller — mlr --ijson --ocsv flatten — وpandas.json_normalize في Python تحكمًا صريحًا في عمق التسطيح وفي ما يُفعل بالقوائم. وإذا كان JSON هرميًا فعلًا لا جدوليًا، فقد يكون تحويله إلى CSV فكرة خاطئة أصلًا — فقاعدة البيانات أو ملف JSON المفصول بالأسطر يحتفظان بالبنية التي توشك الشبكة على التخلص منها.