درک کدهای خطا

فقط مربوط به نسخه Cloud Firestore Enterprise است.

این صفحه کدهای خطایی را که ممکن است با آنها مواجه شوید فهرست می‌کند و پیشنهادهایی برای نحوه رفع هر یک از آنها ارائه می‌دهد.

مهلت تمام شد (262)

موارد زیر می‌توانند خطاهای DeadlineExceeded (262) افزایش دهند:

  • افزایش تأخیر باعث شد که تکمیل یک عملیات بیشتر از مهلت تعیین‌شده (به‌طور پیش‌فرض ۶۰ ثانیه) طول بکشد. 
DeadlineExceeded (262): Deadline exceeded.

برای حل این مشکل، به راهنمای عیب‌یابی تأخیر مراجعه کنید.

لغو شد (112)

شرایط زیر می‌تواند خطاهای Aborted (112) را افزایش دهد:

  • سندی که در هر ثانیه به‌روزرسانی‌های زیادی دریافت می‌کند.
  • اختلاف ناشی از تداخل تراکنش‌ها
  • ترافیکی که به سرعت افزایش می‌یابد یا با نقاط بحرانی مواجه می‌شود. 
Aborted (112): Too much contention on these documents. Please try again

یا

Aborted (112): Aborted due to cross-transaction contention. This occurs when
multiple transactions attempt to access the same data, requiring at least one
to be aborted in order to enforce serializability.

برای حل این مشکل:

  • برای افزایش سریع ترافیک، Cloud Firestore با سازگاری MongoDB تلاش می‌کند تا به طور خودکار برای پاسخگویی به تقاضای افزایش یافته، مقیاس‌بندی کند. هنگامی که Cloud Firestore با سازگاری MongoDB مقیاس‌بندی می‌شود، تأخیر شروع به کاهش می‌کند.
  • نقاط داغ، توانایی Cloud Firestore با سازگاری MongoDB را برای افزایش مقیاس محدود می‌کنند. طراحی برای مقیاس‌پذیری را برای شناسایی نقاط داغ بررسی کنید.
  • تداخل داده‌ها در تراکنش‌ها و نحوه‌ی استفاده‌ی خود از تراکنش‌ها را بررسی کنید.
  • نرخ نوشتن را برای اسناد جداگانه کاهش دهید.

آرگومان نامعتبر (2)

موقعیت‌های زیر می‌توانند باعث ایجاد خطای InvalidArgument (2) شوند:

  • تلاش برای ثبت سندی که حجم آن از حد مجاز ۷.۵ کیلوبایت برای ورودی فهرست فراتر رفته است.

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

InvalidArgument (2): Index entry on field_name is larger than 7680 bytes.

برای حل این مشکل:

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