این ابزار درست کار نمی‌کند؟

دربارهٔ ابزار «چک کردن NDJSON خط‌به‌خط آنلاین»

این ابزار NDJSON (JSON با خط جدید جداکننده) را تأیید می‌کند — فرمتی که در آن هر خط یک سند JSON خودکفا است. NDJSON استاندارد برای استریم گزارش‌ها، خطوط لوله ingest، صادرات داده‌های بزرگ، و هر سیستمی است که در آن رکوردها یکی در یک زمان پردازش می‌شوند.

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

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

چطور از این ابزار استفاده کنم؟

چطور یک فایل NDJSON (هر خط یک JSON) را اعتبارسنجی کنم؟

  1. NDJSON را بچسبانید

    متن را در فیلد «NDJSON» قرار دهید — یک مقدار JSON در هر خط. ابزار با `\n`/`\r\n` تقسیم می‌کند، خالی‌ها را trim می‌کند، سپس `JSON.parse` را روی هر خط باقی‌مانده اجرا می‌کند.

  2. گذشت روی whitespace

    خطوط خالی رد می‌شوند (علامت نمی‌خورند). whitespace انتهای خط تحمل می‌شود — فقط سختگیری parser JSON اعمال می‌شود.

  3. «اجرا» را بزنید

    نتیجه شامل linesValidated (تعداد خطوط غیر خالی)، ok (true اگر همه خطوط parse شدند) و errors[] است — هر ورودی `Line N: <parser error>` است تا مستقیماً به رکورد خراب بپرید.

  4. برای داده‌های log/stream

    NDJSON در shipping log، event streamها و endpointهای bulk-load (Elasticsearch، BigQuery) رایج است. validator یک خط خراب را که در غیر این صورت کل ingestion را لغو می‌کرد، می‌گیرد.