JSON کو CSV میں تبدیل کریں

درخت کو گرڈ میں فلیٹ کرنا

JSON ایک درخت ہے اور CSV ایک مستطیل، اور پوری کنورژن یہی سوال ہے کہ ایک دوسرا کیسے بنے۔ صاف صورت آبجیکٹس کی ایسی array ہے جن سب کی کیز ایک جیسی ہوں — ہر آبجیکٹ ایک رو، ہر کی ایک کالم، اور کچھ ضائع نہیں ہوتا۔ زیادہ تر API ریسپانسز اور ایکسپورٹس ایسے ہی ہوتے ہیں، اسی لیے یہ عموماً بس چل جاتا ہے۔ ہر مشکل ان دستاویزات سے آتی ہے جن کی شکل ایسی نہیں۔

نیسٹڈ آبجیکٹس ان کی کیز جوڑ کر فلیٹ کیے جاتے ہیں، اس لیے کسی کسٹمر کے اندر کا address آبجیکٹ address.city اور address.postcode جیسے کالمز بن جاتا ہے — ایک ایسا رواج جسے ہر اسپریڈشیٹ سنبھالتی ہے اور کوئی معیار طے نہیں کرتا۔ جو کیز کچھ آبجیکٹس میں ہوں اور کچھ میں نہیں، وہ ایسے کالمز بنتی ہیں جو ان رو میں خالی ہوتے ہیں جن میں وہ کیز نہیں تھیں، اور یہی صحیح جواب ہے: متبادل یہ ہے کہ وہ ڈیٹا ہٹا دیا جائے جو صرف کچھ ریکارڈز میں ہے۔

نیسٹڈ arrays وہ جگہ ہیں جہاں گرڈ واقعی ساتھ نہیں دے سکتا۔ جس ریکارڈ کے اندر تین آرڈر لائنز ہوں وہ فہرست والی ایک رو ہے، تین رو نہیں — اسے تین بنانے سے ہر دوسری فیلڈ دہرائی جائے گی اور ڈیٹا کا مطلب خاموشی سے بدل جائے گا۔ اس لیے آبجیکٹس کی ایک array کو رو میں پھیلایا جاتا ہے اور باقی کو ان کے سیل میں ٹیکسٹ کے طور پر لکھا جاتا ہے۔ اگر آپ کو آرڈرز کے بجائے آرڈر لائنز چاہییں تو کنورژن کو اسی array کی طرف موڑیں؛ جس درخت میں دو فہرستیں ساتھ ساتھ ہوں اس کا کوئی ایک درست مستطیل نہیں، اور ایک کو چننا ایسا فیصلہ ہے جو صرف آپ کر سکتے ہیں۔

باہر نکلتے وقت دو تفصیلات مسئلہ بنتی ہیں۔ کوما، کوٹ مارک یا لائن بریک والی ویلیوز کو کوٹ کیا جاتا ہے تاکہ وہ سلامت رہیں — جو درست CSV ہے مگر خام فائل دیکھیں تو عجیب لگتا ہے۔ اور لمبا عددی شناختی نمبر CSV کے اسپریڈشیٹ تک پہنچتے ہی خطرہ بن جاتا ہے: Excel اسے نمبر کے طور پر پڑھے گا، پندرہ ہندسوں کے بعد راؤنڈ کر دے گا اور شروع کا صفر ہٹا دے گا، جو کنورژن کا نہیں بلکہ اسپریڈشیٹ کا پیدا کردہ مسئلہ ہے۔

جب آپ کو کچھ اور چاہیے

جب شکل کا اندازہ لگانے کے بجائے اسے طے کرنا ہو تو jq صحیح ٹول ہے: jq -r '.orders[] | [.id, .customer.name, .total] | @csv' بالکل وہی فیلڈز بالکل اسی لیول سے چنتا ہے جو آپ چاہتے ہیں، اور یہ وہ کنٹرول ہے جو کوئی خودکار فلیٹنر نہیں دے سکتا۔ یہ اسٹریم بھی کرتا ہے، اس لیے فائل کا سائز کوئی مسئلہ نہیں رہتا۔

عام طور پر نیسٹڈ ڈیٹا کے لیے Miller — mlr --ijson --ocsv flatten — اور Python کا pandas.json_normalize آپ کو واضح کنٹرول دیتے ہیں کہ کتنی گہرائی تک فلیٹ کرنا ہے اور فہرستوں کے ساتھ کیا کرنا ہے۔ اور اگر JSON ٹیبل جیسا نہیں بلکہ واقعی درجہ بہ درجہ ہے تو اسے CSV میں تبدیل کرنا شاید سرے سے غلط خیال ہو — ڈیٹا بیس یا لائن ڈیلیمیٹڈ JSON فائل وہ ساخت برقرار رکھتی ہے جسے گرڈ ضائع کرنے والا ہے۔