لاگ درخواست‌های رد شده
جدول سیستمی dl_dropped_requests صرفاً درخواست‌هایی را ثبت می‌کند که پس از عبور از اندپوینت، در مرحله اعتبارسنجی داده‌ها (نظیر نقص ستون‌های اجباری یا ساختار نامعتبر) رد شده‌اند؛ بنابراین خطاهای لایه اندپوینت در این جدول لاگ نمی‌شوند. در درخواست‌های گروهی (ارسال Bulk در POST یا فایل CSV)، پردازش به صورت اتمیک انجام می‌پذیرد و با بروز خطا در نخستین ردیف، کل درخواست متوقف شده و تنها گزارش همان ردیف معیوب ذخیره می‌گردد. این جدول هم از طریق رابط کاربری و هم با نگارش کوئری‌های SQL قابل پایش است.
دسترسی و سطح اختیارات
دسترسی به لاگ‌های خطای ورود داده از دو مسیر میسر است:
- رابط کاربری: در مسیر
مدیریت دیتاست>لاگ درخواست‌های رد شده، گزارش رکوردهای ناموفق نمایش داده می‌شود. در این بخش، هر کاربر تنها لاگ‌های مربوط به جداولی را مشاهده می‌کند که بر روی آن‌ها حداقل دسترسی ویرایش یا مدیریت داشته باشد. - صفحه کوئری: کاربران دارای دسترسی کوئری می‌توانند با دستور
SELECTمستقیماً جدولdl_dropped_requestsرا فراخوانی کرده و وضعیت خطاها را بررسی نمایند.
دوره نگهداری داده‌ها
اطلاعات موجود در جدول dl_dropped_requests صرفاً با هدف خطایابی کوتاه‌مدت نگهداری می‌شوند. داده‌های این جدول حداکثر به مدت ۷ روز حفظ می‌گردند و رکوردهای قدیمی‌تر از ۷ روز به صورت خودکار و دائمی از سیستم پاک می‌شوند.
ستون‌های جدول
جدول سیستمی dl_dropped_requests دارای ۱۲ ستون مشخص به شرح زیر است:
| نام ستون | توضیحات |
|---|---|
request_id | شناسه یکتای پیگیری درخواست را نگهداری می‌کند و با مقدار ارسالی در پاسخ API تطابق دارد. |
record_time | زمان دقیق ثبت و رد شدن داده توسط سیستم را با دقت میکروثانیه نشان می‌دهد. |
error | شرح علت بروز خطا و دلیل رد شدن داده را به زبان فارسی بیان می‌کند. |
endpoint | نشانی کامل اندپوینتی را که درخواست به آن ارسال شده است مشخص می‌سازد. |
table_name | نام فنی جدول مقصد در داده‌لند را مشخص می‌کند. |
request | محتوای ردیف ردشده را ذخیره می‌نماید (در درخواست‌های گروهی POST و CSV، صرفاً اولین ردیف خطادار ثبت می‌شود). |
source | شیوه یا مبدا ارسال درخواست (مانند ENDPOINT) را مشخص می‌سازد. |
file_name | نام فایل متنی ورودی را نشان می‌دهد و صرفاً هنگام لود داده با فایل CSV دارای مقدار است. |
method | متد پروتکل HTTP درخواست ارسالی (مانند GET یا POST) را مشخص می‌کند. |
status | کد وضعیت خطای سیستمی (مانند 1101) را گزارش می‌دهد. |
size | اندازه بدنه درخواست ارسالی را بر حسب بایت نمایش می‌دهد. |
ip | آدرس IP سرور یا فرستنده درخواست را ثبت می‌کند. |