JSON থেকে CSV-তে কনভার্ট করুন

একটি ট্রি-কে গ্রিডে সমতল করা

JSON একটি ট্রি আর CSV একটি আয়তক্ষেত্র, আর পুরো কনভার্শনটিই হলো একটি থেকে অন্যটি কীভাবে হবে, সেই প্রশ্ন। পরিষ্কার ক্ষেত্রটি হলো এমন অবজেক্টের অ্যারে, যাদের সবার কি একই — প্রতিটি অবজেক্ট একটি সারি, প্রতিটি কি একটি কলাম, আর কিছুই হারায় না। বেশিরভাগ API রেসপন্স ও এক্সপোর্ট দেখতে এমনই, তাই সাধারণত এটি এমনিতেই কাজ করে। যত ঝামেলা আসে সেই ডকুমেন্টগুলো থেকে, যেগুলো এই আকারের নয়।

নেস্টেড অবজেক্ট তাদের কি জুড়ে সমতল করা হয়, তাই কোনো গ্রাহকের ভেতরের address অবজেক্ট address.city ও address.postcode-এর মতো কলাম হয় — এমন একটি রীতি, যা প্রতিটি স্প্রেডশিট সামলায় অথচ কোনো স্ট্যান্ডার্ড সংজ্ঞায়িত করে না। যে কি কিছু অবজেক্টে আছে আর কিছুতে নেই, সেগুলো এমন কলাম হয় যা যেসব সারিতে সেটি ছিল না সেখানে খালি থাকে — আর এটাই সঠিক উত্তর: বিকল্প হলো এমন ডেটা বাদ দেওয়া, যা শুধু কিছু রেকর্ডে আছে।

নেস্টেড অ্যারেতেই একটি গ্রিড সত্যিকার অর্থে পেরে ওঠে না। ভেতরে তিনটি অর্ডার লাইনসহ একটি রেকর্ড মানে একটি তালিকাসহ একটি সারি, তিনটি সারি নয় — তিনটিতে ভাগ করলে বাকি প্রতিটি ফিল্ড দ্বিগুণ হতো এবং ডেটার অর্থ নিঃশব্দে বদলে যেত। তাই একটি অবজেক্টের অ্যারে সারিতে ছড়ানো হয় আর বাকিগুলো তাদের সেলে লেখা হিসেবে লেখা হয়। আপনার যদি অর্ডারের বদলে অর্ডার লাইনগুলোই দরকার হয়, তবে কনভার্শনটি সেই অ্যারের দিকে তাক করুন; পাশাপাশি দুটি তালিকাওয়ালা ট্রি-র কোনো একক সঠিক আয়তক্ষেত্র নেই, আর একটি বেছে নেওয়ার সিদ্ধান্ত শুধু আপনিই নিতে পারেন।

বের হওয়ার পথে দুটি খুঁটিনাটি ঝামেলা করে। কমা, উদ্ধৃতিচিহ্ন বা লাইন ব্রেকওয়ালা মান কোট করা হয় যাতে সেগুলো টিকে থাকে — এটি সঠিক CSV, যদিও কাঁচা ফাইল খুললে অদ্ভুত দেখায়। আর লম্বা সংখ্যার আইডি CSV স্প্রেডশিটে পৌঁছালে বিপদ: Excel এটিকে সংখ্যা হিসেবে পড়বে, পনেরো অঙ্কের পর রাউন্ড করবে এবং শুরুর যেকোনো শূন্য বাদ দেবে — সমস্যাটি কনভার্শনের নয়, স্প্রেডশিটের তৈরি।

অন্য কিছু দরকার হলে

আকার আন্দাজ না করে যখন ঠিক করে দিতে হয়, তখন jq-ই সঠিক টুল: jq -r '.orders[] | [.id, .customer.name, .total] | @csv' ঠিক যে ফিল্ডগুলো চান, ঠিক যে স্তর থেকে চান, সেখান থেকে বেছে নেয় — এই নিয়ন্ত্রণ স্বয়ংক্রিয় কোনো ফ্ল্যাটেনার দিতে পারে না। এটি স্ট্রিমও করে, তাই ফাইলের সাইজ আর বিবেচ্য থাকে না।

সাধারণভাবে নেস্টেড ডেটার জন্য Miller — mlr --ijson --ocsv flatten — আর Python-এর pandas.json_normalize আপনাকে স্পষ্ট নিয়ন্ত্রণ দেয়, কত গভীর পর্যন্ত সমতল করবেন আর তালিকা নিয়ে কী করবেন। আর JSON যদি টেবিলের মতো না হয়ে সত্যিই স্তরবিন্যস্ত হয়, তবে CSV-তে কনভার্ট করাই হয়তো পুরোপুরি ভুল ভাবনা — একটি ডেটাবেস বা লাইন-বিভাজিত JSON ফাইল সেই কাঠামো রাখে, যা একটি গ্রিড বাদ দিতে চলেছে।