تبدیل JSON به CSV JavaScript Object Notation ↔ Comma-Separated Values رایگان آنلاین امن

چرا مردم JSON را به CSV تبدیل می‌کنند

JSON زبانی است که برنامه‌ها با آن با هم صحبت می‌کنند. خروجی یک سرویس وب، پاسخ یک API، پیکربندی ذخیره‌شده توسط یک برنامه، یک نسخهٔ کامل از پایگاه داده: بیشتر آن‌ها به شکل JSON می‌رسند. برای نرم‌افزار عالی است و برای آدم‌ها دست‌وپاگیر، چون صفحه‌ای پر از کروشه، گیومه و ویرگول چیزی نیست که بتوانید مرتب، فیلتر یا جمع کنید. CSV درست نقطهٔ مقابل است: جدولی ساده، هر ردیف در یک خط، سلول‌ها با ویرگول جدا شده‌اند و در هر صفحه‌گسترده‌ای روی زمین باز می‌شود. به همین دلیل مردم JSON را به CSV تبدیل می‌کنند: دادهٔ تولیدشده توسط برنامه را دارند و می‌خواهند آن را ببینند، بشمارند یا به کسی بدهند که در صفحه‌گسترده زندگی می‌کند.

موقعیت‌ها آشنا هستند. تحلیل‌گری که رکوردها را از یک API کشیده و جدول محوری می‌خواهد. صاحب فروشگاهی که سفارش‌ها را از یک پلتفرم آنلاین خروجی گرفته و در Excel لازم دارد. پژوهشگری که نتایج یک نظرسنجی را با ابزاری ذخیره کرده است. توسعه‌دهنده‌ای که می‌خواهد چند صد رکورد را یک‌جا بررسی کند. در هر مورد داده از پیش ساختار دارد و تنها چیزی که کم است خود جدول است.

این صفحه JSON را در مرورگر شما به CSV تبدیل می‌کند. فایل شما همین‌جا خوانده و نوشته می‌شود و هرگز دستگاه شما را ترک نمی‌کند، که برای فهرست مشتریان، سفارش‌ها و هر چیز شخصی دیگر اهمیت دارد. و صفحه از پیش به شما می‌گوید این گذار چه چیزی را نگه می‌دارد و چه چیزی را نمی‌تواند، به جای آنکه خودتان بعداً کشفش کنید. در ادامه می‌خوانید تبدیل چگونه کار می‌کند، کدام نوع JSON می‌تواند جدول شود و بر سر بقیه چه می‌آید.

تبدیل چگونه کار می‌کند

کلیدها سطر سرستون می‌شوند، به ترتیب اولین ظهور

فایل JSON شما داخل مرورگرتان خوانده می‌شود. کلیدهای رکوردها به ردیف سرستون CSV تبدیل می‌شوند، به ترتیبی که برای نخستین بار ظاهر شده‌اند. سپس هر رکورد یک ردیف می‌شود و هر مقدار همان‌طور که هست نوشته می‌شود. اگر به خط اول نتیجه نگاه کنید، نام فیلدها را می‌بینید؛ زیر آن‌ها برای هر رکورد یک خط.

کلید غایب یک سلول خالی به جا می‌گذارد

رکوردها همیشه یکدست نیستند. ممکن است یکی فیلدی را نداشته باشد که بقیه دارند. در آن صورت ردیفی که کلیدی ندارد به جای جابه‌جا کردن ستون‌ها یک سلول خالی به جا می‌گذارد. ستون سر جای خودش می‌ماند و سلول فقط خالی است، پس جدول هم‌تراز می‌ماند.

هر ردیف و هر ستون

هیچ چیز حذف نمی‌شود. هر رکورد یک ردیف می‌شود و هر کلیدی که در هر جایی ظاهر شود یک ستون. لازم نیست نگران باشید فیلدی که فقط در رکورد هزارم ظاهر می‌شود جا بماند.

چه چیزی حفظ می‌شود

همهٔ ردیف‌ها و همهٔ ستون‌ها

هر ردیف و هر ستون حفظ می‌شود. دادهٔ شما همان است که به صورت جدول تحویل می‌گیرید.

مقدارها همان‌طور که هستند

هر مقدار همان‌طور که هست نوشته می‌شود. عددها عدد می‌مانند، متن متن می‌ماند و مقدارهایی که ویرگول یا گیومه دارند درست داخل نقل‌قول قرار می‌گیرند تا صفحه‌گسترده آن‌ها را یک سلول بخواند.

ترتیب فیلدها

ستون‌ها از ترتیبی پیروی می‌کنند که کلیدها برای نخستین بار در آن ظاهر شدند، که معمولاً همان ترتیبی است که برنامهٔ تولیدکنندهٔ فایل به کار برده است. این کار جدول را برای هر کسی که داده را در شکل اصلی‌اش دیده آشنا نگه می‌دارد.

آنچه پیش از تبدیل JSON به CSV باید بدانید

فقط یک شکل JSON از پیش جدول است

فقط یک شکل JSON از پیش جدول است: آرایه‌ای از شیءهای مسطح، مانند فهرستی از رکوردها که هرکدام فیلدهایی از یک نوع دارند. یک شیء تنها، یا درختی که شیء درون شیء دارد، ردیفی برای نوشتن ندارد و رد می‌شود، به جای آنکه به چیزی که نخواسته‌اید مسطح شود. این انتخابی عمدی است. مسطح کردن یک درخت تصمیم‌هایی دربارهٔ نام‌ها و دربارهٔ اینکه کدام شاخه‌ها بمانند می‌طلبد و حدس نادرست جدولی می‌سازد که درست به نظر می‌رسد و نیست.

مقدارهای تودرتو به صورت متن JSON نوشته می‌شوند

جایی که یک مقدار خودش فهرست یا شیء است، به صورت متن JSON در سلول نوشته می‌شود، چون سلول نمی‌تواند شاخه‌ای را در خود جای دهد. بنابراین رکوردی با فیلد برچسب‌ها که فهرستی را نگه می‌دارد، آن فهرست را به صورت متن در یک سلول نشان می‌دهد. همه‌چیز آنجاست و اگر خواستید می‌توانید با ابزارهای صفحه‌گسترده‌تان آن را تقسیم کنید.

CSV نوع ندارد

فایل CSV متن است. اینکه 007 عدد است یا کد را صفحه‌گسترده هنگام باز کردن فایل تصمیم می‌گیرد و صفحه‌گسترده‌ها به حدس‌های غلط مشهورند. صفرهای ابتدایی، عددهای بلند و تاریخ‌ها هنگام باز شدن ممکن است تغییر کنند. اگر این مهم است، فایل را با گفت‌وگوی وارد کردن (import) وارد کنید و چنین ستون‌هایی را به عنوان متن علامت بزنید.

چگونه اینجا JSON را به CSV تبدیل کنیم

فایل خود را اضافه کنید

فایل JSON را روی صفحه رها کنید یا از دستگاه خود انتخاب کنید. داخل مرورگر شما خوانده می‌شود و بارگذاری نمی‌شود.

تبدیل کنید

دکمه را فشار دهید. فایلی با اندازهٔ معمولی لحظه‌ای طول می‌کشد. صفحه را تا پایان کار باز نگه دارید.

دانلود کنید و باز کنید

CSV را دانلود کنید و در برنامهٔ صفحه‌گسترده‌تان یا در ویرایشگر متن برای نگاه کردن باز کنید. سرستون، چند ردیف میانی و ردیف آخر را بررسی کنید.

نگاهی دقیق‌تر به JSON و CSV

درخت‌ها و جدول‌ها

JSON یک درخت را توصیف می‌کند: شیءهایی که مقدارهایی دارند که به نوبهٔ خود ممکن است شیء یا فهرست باشند. CSV یک جدول را توصیف می‌کند: ردیف و ستون، نه بیشتر. درخت می‌تواند چیزهایی را در خود نگه دارد که جدول نمی‌تواند، مثل شاخه‌ای که زیرش شاخه‌های متفاوتی دارد. در مقابل، جدولی که فهرستی از رکوردهای یکدست است، بدون هیچ اتلافی در JSON نوشته می‌شود. تبدیل JSON به CSV یعنی رفتن از شکل کلی به شکل خاص، و وقتی کار می‌کند که داده از اول واقعاً جدول بوده باشد، روان پیش می‌رود.

چرا سخت‌گیری مفید است

ابزارهایی که هر JSON را می‌پذیرند و خودکار مسطحش می‌کنند اغلب نام ستون‌هایی مانند address.street یا items.0.price اختراع می‌کنند. این تا وقتی که لازم نشود بدانید چه اتفاقی افتاده راحت است. با پذیرفتن فقط شکلی که از پیش جدول است، این صفحه شما را از تصمیم‌های بی‌صدا معاف می‌کند. اگر فایلتان درخت باشد، فوراً می‌دانید.

ویرگول، گیومه و شکست خط

CSV تله‌های خودش را دارد: ویرگول در درون یک مقدار، یک گیومه، یک شکست خط در میانهٔ سلول. این‌ها با نقل‌قول گذاشتن دور سلول و دوبرابر کردن گیومه‌های درون آن اداره می‌شوند تا صفحه‌گسترده جدول را همان‌طور که مقصود بوده بخواند.

موقعیت‌های رایج با جزئیات

خروجی سرویس‌های وب و API‌ها

بیشتر سرویس‌ها فهرست‌هایی از رکوردها را به صورت JSON برمی‌گردانند. اگر آن‌ها را در صفحه‌گسترده می‌خواهید، JSON را به CSV تبدیل کنید و نتیجه را باز کنید. سریع‌ترین راه از پاسخ API تا جدول محوری است.

سفارش‌ها، مشتریان و محصولات

پلتفرم‌های فروشگاهی اغلب به شما اجازه می‌دهند داده را به صورت JSON خروجی بگیرید. CSV سفارش‌ها یا محصولات را می‌توان با چند کلیک بر پایهٔ تاریخ مرتب کرد، بر پایهٔ مشتری فیلتر کرد یا بر پایهٔ محصول جمع زد.

نتایج نظرسنجی و گزارش‌ها

ابزارهایی که پاسخ‌های نظرسنجی یا گزارش رویدادها را به صورت JSON ذخیره می‌کنند، برای هر پاسخ یا رویداد یک رکورد تولید می‌کنند. به صورت CSV می‌توان آن‌ها را شمرد، نمودار کرد و مقایسه کرد.

بررسی داده با یک نگاه

توسعه‌دهندگان اغلب چند صد رکورد را فقط برای خواندن به CSV تبدیل می‌کنند. اسکن جدول از اسکن آکولادهای تودرتو آسان‌تر است و صفحه‌گسترده می‌تواند موارد غیرعادی را مرتب و برجسته کند.

توصیه‌های عملی پیش از تبدیل JSON به CSV

شکل فایل خود را بررسی کنید

JSON را در ویرایشگر متن باز کنید. اگر با کروشه شروع می‌شود و فهرستی از رکوردهای آکولادی با مقدارهای ساده دارد، شکل درست است. اگر با آکولاد شروع می‌شود و رکوردها درونش تودرتو هستند، فهرست لازم را پیدا کنید و اول آن را جدا کنید.

بدانید کدام مقدارها تودرتو هستند

اگر بعضی فیلدها فهرست یا شیء دارند، در سلول‌هایشان به صورت متن JSON ظاهر می‌شوند. تصمیم بگیرید آیا تقسیمشان لازم است و برنامه‌ریزی کنید که در صفحه‌گسترده انجام شود.

مراقب کدگذاری و جداکننده باشید

CSV با ویرگول نوشته می‌شود. بعضی صفحه‌گسترده‌ها در بعضی منطقه‌ها نقطه‌ویرگول انتظار دارند. اگر فایل به صورت یک ستون باز شد، از قابلیت وارد کردن استفاده کنید و جداکننده را تنظیم کنید.

فایل‌های بزرگ

همه‌چیز روی دستگاه شما اجرا می‌شود، پس فایلی بسیار بزرگ حافظه می‌خواهد. برای فایل‌های چند مگابایتی از رایانه استفاده کنید و اگر صفحه به زحمت افتاد داده را تقسیم کنید.

پرسش‌هایی که مردم پیش از تبدیل می‌پرسند

چرا فایل من رد شد؟

چون آرایه‌ای از شیءهای مسطح نیست. یک شیء تنها، یا درختی که شیء درون شیء دارد، ردیفی برای نوشتن ندارد. فهرست لازم را جدا کنید و آن را تبدیل کنید.

بر سر رکوردی که فیلدی ندارد چه می‌آید؟

در آن ستون یک سلول خالی به جا می‌گذارد. ستون‌ها جابه‌جا نمی‌شوند.

بر سر فهرست‌های درون یک رکورد چه می‌آید؟

به صورت متن JSON در سلول نوشته می‌شوند، چون سلول نمی‌تواند شاخه‌ای را در خود جای دهد.

چرا صفرهای ابتدایی من در صفحه‌گسترده ناپدید می‌شوند؟

چون صفحه‌گسترده هنگام باز کردن فایل تصمیم گرفته ستون عددی است. CSV صفرها را دارد؛ از گفت‌وگوی وارد کردن استفاده کنید و ستون را به عنوان متن علامت بزنید.

آیا فایل من بارگذاری می‌شود؟

خیر. تبدیل در مرورگر شما اجرا می‌شود و فایل هرگز دستگاه شما را ترک نمی‌کند.

می‌توانم به JSON برگردم؟

بله. تبدیل CSV به JSON جدول را به فهرستی از رکوردها برمی‌گرداند.

انتخاب هوشمندانه هنگام تبدیل JSON به CSV

CSV یا یک صفحه‌گسترده واقعی؟

اگر فایلی می‌خواهید که در Excel با برگهٔ درست باز شود، تبدیل JSON به XLSX همان جدول را به صورت کارپوشه می‌نویسد. CSV سبک‌تر و فراگیرتر است؛ XLSX بدون هیچ مرحلهٔ وارد کردن باز می‌شود.

مقصدهای دیگر

اگر مقصد پیکربندی یا فایل نشانه‌گذاری است، تبدیل JSON به XML و تبدیل JSON به YAML این نیازها را برآورده می‌کنند.

JSON را نگه دارید

JSON نسخهٔ اصلی است. ساختار و نوع‌ها را در خود دارد. آن را نگه دارید و CSV را نمایی از داده بدانید.

گرفتن نتیجهٔ خوب پس از تبدیل

وارد کنید، فقط باز نکنید

وقتی فایل کد، شمارهٔ تلفن یا تاریخ دارد، از گفت‌وگوی وارد کردن صفحه‌گسترده استفاده کنید و نوع هر ستون را تنظیم کنید. این کار از آسیب بی‌صدایی که حدس خودکار می‌تواند بزند جلوگیری می‌کند.

چند ردیف را با منبع مقایسه کنید

چند رکورد جدول را با JSON مقایسه کنید. یک دقیقه طول می‌کشد و به شما می‌گوید جدول وفادار است.

در صورت نیاز سلول‌های تودرتو را تقسیم کنید

اگر سلولی فهرستی را به صورت متن دارد، از ابزار تبدیل متن به ستون یا از یک فرمول برای تقسیم آن استفاده کنید. یا برگردید و JSON را طوری آماده کنید که هر مورد رکورد جداگانه‌ای داشته باشد.

آماده کردن JSON برای تبدیل خوب

پیش از تبدیل JSON به CSV داده را شکل بدهید

اگر فایل شما درخت است، معمولاً می‌توانید پیش از تبدیل JSON به CSV آن را به فهرستی از رکوردهای مسطح تغییر شکل دهید. فهرستی را انتخاب کنید که چیزی را که می‌خواهید بشمارید در خود دارد: سفارش‌ها، مشتریان، رویدادها. آن را در فایلی جداگانه کپی کنید، با کروشه‌ها دورش، و صفحه آن را می‌پذیرد. این گام کوچک تفاوت میان رد شدن و جدولی تمیز است.

نام فیلدها را معنادار نگه دارید

کلیدها سرستون می‌شوند، پس هرچه نام‌ها روشن‌تر باشند جدول خواناتر است. اگر منبع در اختیار شماست، به جای اختصاراتی که فقط برنامه‌نویس می‌فهمد، از نام‌هایی مانند order_date و customer_name استفاده کنید.

در نوع‌ها یکدست باشید

فیلدی که در بیشتر رکوردها عدد و در چند رکورد متن دارد، صفحه‌گسترده را گیج می‌کند. اگر می‌توانید، موارد غیرعادی را پیش از تبدیل پاک کنید تا هر ستون یک معنا داشته باشد.

به تاریخ‌ها فکر کنید

تاریخ‌ها در JSON معمولاً متنی در قالبی توافق‌شده‌اند. همان‌طور که هستند در CSV نوشته می‌شوند. پس از تبدیل JSON به CSV، هنگام وارد کردن به صفحه‌گسترده بگویید چگونه بخواندشان تا آن‌ها را تاریخ بداند و بگذارد بر پایهٔ زمان مرتب و فیلتر کنید.

اول روی یک تکهٔ کوچک آزمایش کنید

اگر فایلتان بزرگ است، بیست رکورد اول را در فایل آزمایشی کپی کنید و آن را تبدیل کنید. نگاهی سریع به نتیجه نشان می‌دهد شکل و نام فیلدها همان است که انتظار دارید، پیش از آنکه وقت صرف کل کار شود.

حریم خصوصی و نحوهٔ برخورد

چرا تبدیل محلی برای داده مهم است

فایل‌های داده اغلب چیزهای خصوصی در خود دارند: مشتریان، سفارش‌ها، نشانی‌ها، پیام‌ها. بسیاری از مبدل‌های آنلاین فایل شما را روی یک سرور بارگذاری می‌کنند، پردازش می‌کنند و نتیجه را پس می‌فرستند، و مدتی نسخه‌ای روی ماشینی می‌ماند که شما کنترلی بر آن ندارید. اینجا مرورگر خودتان کار را انجام می‌دهد، پس داده روی دستگاه شما می‌ماند.

وقتی می‌روید چه می‌شود

وقتی صفحه را می‌بندید، فایل تبدیل‌شده از مرورگر ناپدید می‌شود، پس اول آن را دانلود کنید. هیچ چیز دربارهٔ داده‌تان نگه داشته نمی‌شود.

اگر چیزی اشتباه پیش رفت

صفحه می‌گوید فایل JSON معتبر نیست

ممکن است ویرگولی اضافه، گیومه‌ای غایب یا کروشه‌ای که بسته نمی‌شود وجود داشته باشد. فایل را در ویرایشگری که خطاهای JSON را برجسته می‌کند باز کنید و خطی را که نشان می‌دهد اصلاح کنید.

ستون‌ها درهم‌ریخته به نظر می‌رسند

ممکن است صفحه‌گسترده شما جداکنندهٔ دیگری انتظار داشته باشد. فایل را وارد کنید و جداکننده را روی ویرگول بگذارید.

صفحه با فایل بزرگ قفل می‌کند

همه‌چیز روی دستگاه شما اجرا می‌شود و فایل بزرگ حافظه می‌خواهد. دوباره روی رایانه امتحان کنید یا داده را تقسیم کنید.

ابزارهای مرتبط

همین خانوادهٔ ابزارها کارهای همسایه را پوشش می‌دهد. برای بازگشت از تبدیل CSV به JSON استفاده کنید. برای کارپوشه، تبدیل JSON به XLSX و تبدیل XLSX به JSON با فایل‌های Excel کار می‌کنند. برای قالب‌های دیگر دادهٔ ساخت‌یافته تبدیل JSON به XML، تبدیل XML به JSON، تبدیل JSON به YAML و تبدیل YAML به JSON هست. وقتی رقم‌ها در PDF هستند، تبدیل PDF به XLS جدول را از روی صفحه بازسازی می‌کند.

یک مثال عملی

فرض کنید 500 سفارش را از یک فروشگاه آنلاین به صورت فایل JSON خروجی گرفته‌اید و می‌خواهید بدانید کدام محصولات بهتر فروش می‌روند. فایل را اینجا رها می‌کنید و دکمه را می‌فشارید. لحظه‌ای بعد CSV‌ای دانلود می‌کنید با سرستونی از نام فیلدها و 500 ردیف زیر آن. آن را به صفحه‌گسترده‌تان وارد می‌کنید، کد محصول را به عنوان متن علامت می‌زنید، جدول محوری می‌سازید و پاسخ را می‌بینید. JSON در پوشه‌تان به عنوان منبع می‌ماند.

یک فهرست کنترل کوتاه

پیش از تبدیل

بررسی کنید فایل فهرستی از رکوردهاست. یادداشت کنید کدام فیلدها تودرتو هستند. JSON را نگه دارید.

هنگام تبدیل

تا آماده شدن فایل روی صفحه بمانید.

پس از تبدیل

CSV را با نوع‌های درست وارد کنید، چند ردیف را با منبع مقایسه کنید و جدول را در قالب صفحه‌گسترده‌تان ذخیره کنید.

اشتباه‌های رایج

دادن یک درخت به آن

انتظار نداشته باشید JSON فایلی عمیقاً تودرتو را به CSV تبدیل کنید. اول فهرست رکوردها را جدا کنید.

باز کردن با دوبار کلیک و اعتماد به نتیجه

صفحه‌گسترده‌ها نوع را حدس می‌زنند. برای کدها و تاریخ‌ها با نوع‌های صریح وارد کنید.

حذف JSON

آن را نگه دارید. ساختاری را دارد که جدول نمی‌تواند.

داده‌تان روی دستگاهتان می‌ماند

تبدیل به صورت محلی انجام می‌شود. فایل شما توسط مرورگر خودتان خوانده، همان‌جا بازنویسی و به شکل CSV تحویل داده می‌شود. چیزی بارگذاری نمی‌شود، پس هیچ نسخه‌ای روی سرور نمی‌ماند و هیچ‌کس دیگر نمی‌تواند آن را بخواند. برای داده‌ای با محتوای خصوصی، این راه ایمن برای تبدیل JSON به CSV است.

خلاصه

برای تبدیل JSON به CSV در اینجا، فایل را رها کنید و دکمه را بفشارید. در مرورگر شما خوانده و نوشته می‌شود، پس فایل هرگز دستگاه شما را ترک نمی‌کند. هر ردیف و هر ستون حفظ می‌شود: کلیدها سرستون می‌شوند، به ترتیب اولین ظهور، و هر مقدار همان‌طور که هست نوشته می‌شود. ردیفی که کلیدی ندارد به جای جابه‌جا کردن ستون‌ها یک سلول خالی به جا می‌گذارد. فقط یک شکل JSON از پیش جدول است، آرایه‌ای از شیءهای مسطح. یک شیء تنها، یا درختی که شیء درون شیء دارد، ردیفی برای نوشتن ندارد و رد می‌شود، به جای آنکه به چیزی که نخواسته‌اید مسطح شود. جایی که یک مقدار خودش فهرست یا شیء است، به صورت متن JSON در سلول نوشته می‌شود، چون سلول نمی‌تواند شاخه‌ای را در خود جای دهد.