Memahami kode error
Halaman ini mencantumkan kode error yang mungkin Anda alami dan memberikan saran tentang cara memperbaiki setiap error tersebut.
DEADLINE_EXCEEDED
Berikut ini dapat meningkatkan jumlah error DEADLINE_EXCEEDED:
- Peningkatan latensi menyebabkan operasi memerlukan waktu lebih lama dari batas waktu (60 detik secara default) untuk selesai.
DEADLINE_EXCEEDED A deadline was exceeded on the server.
Untuk mengatasi masalah ini, lihat panduan pemecahan masalah latensi.
ABORTED
Situasi berikut dapat meningkatkan jumlah error ABORTED:
- Dokumen menerima terlalu banyak update per detik.
- Pertentangan dari transaksi yang tumpang tindih.
- Peningkatan traffic yang melebihi aturan 500-50-5 atau mengalami hot spot.
ABORTED Too much contention on these datastore entities. Please try again.
Atau
ABORTED Aborted due to cross-transaction contention. This occurs when multiple transactions attempt to access the same data, requiring Firestore to abort at least one in order to enforce serializability.
Untuk menyelesaikan masalah ini:
- Untuk peningkatan traffic yang cepat, Firestore akan mencoba melakukan penskalaan otomatis untuk memenuhi peningkatan permintaan. Saat Firestore melakukan penskalaan, latensi mulai menurun.
- Hot spot membatasi kemampuan Firestore untuk meningkatkan skala. Tinjau mendesain untuk penskalaan guna mengidentifikasi hot spot.
- Tinjau pertentangan data dalam transaksi dan penggunaan transaksi Anda.
- Kurangi kecepatan penulisan untuk setiap dokumen.
RESOURCE_EXHAUSTED
Situasi berikut dapat menyebabkan error RESOURCE_EXHAUSTED:
Anda melampaui kuota paket gratis dan penagihan tidak diaktifkan untuk project Anda.
Peningkatan traffic tidak mengikuti praktik terbaik
RESOURCE_EXHAUSTED Some resource has been exhausted, perhaps a per-user quota.
Atau
RESOURCE_EXHAUSTED This database has exceeded their daily quota or the ramp up limit for writes, please retry with exponential backoff. To learn more about limits, see 'Usage and limits' section of the support documentation.
Untuk menyelesaikan masalah ini:
Jika Anda telah mencapai kuota paket gratis, tunggu hingga kuota paket gratis direset setiap hari atau aktifkan penagihan untuk project Anda.
Untuk peningkatan traffic yang cepat, Firestore akan mencoba melakukan penskalaan otomatis untuk memenuhi peningkatan permintaan. Saat Firestore melakukan penskalaan, error mungkin berkurang.
Hot spot membatasi kemampuan Firestore untuk meningkatkan skala. Tinjau mendesain untuk penskalaan guna mengidentifikasi hot spot.
Untuk kueri pendengar real-time, pastikan kueri tidak terlalu luas. Gunakan filter untuk mengurangi jumlah pembaruan.
INVALID_ARGUMENT
Situasi berikut dapat menyebabkan error INVALID_ARGUMENT:
- Mencoba melakukan commit dokumen dengan nilai kolom yang diindeks lebih besar dari 1.500 byte. Batas ini berlaku untuk encoding UTF-8 dari nilai kolom.
- Mencoba melakukan commit dokumen dengan nilai kolom yang tidak diindeks yang lebih besar dari 1.048.487 byte (1 MiB - 89 byte). Batas ini berlaku untuk jumlah nilai kolom dalam dokumen. Misalnya, empat kolom berukuran 256 KiB masing-masing melebihi batas.
1.500 byte (terindeks) dan 1.048.487 byte (tidak terindeks) adalah batas untuk nilai kolom. Anda tidak dapat melampaui batas ini dan batas ini bukan kuota yang dapat disesuaikan.
INVALID_ARGUMENT: The value of property field-name is longer than 1500 bytes
atau
INVALID_ARGUMENT: The value of property field_name is longer than 1048487 bytes
Untuk menyelesaikan masalah ini:
- Untuk nilai kolom yang diindeks, bagi kolom menjadi beberapa kolom. Jika memungkinkan, buat kolom yang tidak diindeks dan pindahkan data yang tidak perlu diindeks ke kolom yang tidak diindeks.
- Untuk nilai kolom yang tidak diindeks, bagi kolom menjadi beberapa kolom atau terapkan kompresi untuk nilai kolom.