Mendiagnosis dan memecahkan masalah pengecualian permintaan buruk di Azure Cosmos DB
BERLAKU UNTUK: NoSQL
Kode status HTTP 400 mewakili permintaan berisi data invalid atau tidak ada parameter yang diperlukan.
Properti ID tidak ditemukan
Pada skenario ini, umum untuk melihat kesalahan:
Konten input tidak valid karena properti yang diperlukan - 'id; ' - tidak ada
Respons dengan kesalahan ini berarti dokumen JSON yang dikirim ke layanan tidak memiliki properti ID yang diperlukan.
Solusi
Tentukan properti id
dengan nilai string sesuai spesifikasi REST sebagai bagian dari dokumen Anda, SDK tidak autogenerasi nilai untuk properti ini.
Jenis kunci partisi tidak valid
Pada skenario ini, umum untuk melihat kesalahan:
Kunci partisi ... invalid.
Respons dengan kesalahan ini berarti nilai kunci partisi berjenis invalid.
Solusi
Nilai kunci partisi harus berupa untai atau angka, pastikan nilainya berjenis yang sesuai.
Nilai kunci partisi salah
Pada skenario ini, umum untuk melihat kesalahan:
Kode status respons tidak menunjukkan keberhasilan: BadRequest (400); Substatus: 1001
PartitionKey yang diekstrak dari dokumen tidak cocok dengan yang ditentukan di header
Respons dengan kesalahan ini berarti Anda menjalankan operasi dan meneruskan nilai kunci partisi yang tidak cocok dengan nilai isi dokumen untuk properti yang diharapkan. Jika jalur kunci partisi koleksi adalah /myPartitionKey
, dokumen memiliki properti yang disebut myPartitionKey
dengan nilai yang tidak cocok dengan nilai kunci partisi saat memanggil metode SDK.
Solusi
Kirim parameter nilai kunci partisi yang cocok dengan nilai properti dokumen.
Kehilangan presisi nilai kunci partisi numerik
Pada skenario ini, umum untuk melihat kesalahan:
Kunci partisi yang diminta berada di luar rentang kunci, mungkin karena hilangnya presisi nilai kunci partisi
Respons dengan kesalahan ini kemungkinan disebabkan oleh operasi pada dokumen dengan kunci partisi numerik yang nilainya berada di luar apa yang didukung oleh Azure Cosmos DB. Lihat Batas per item untuk panjang maksimum nilai properti numerik.
Solusi
Pertimbangkan untuk menggunakan jenis string
untuk kunci partisi jika memerlukan nilai numerik yang tepat.
Langkah berikutnya
- Mendiagnosis dan memecahkan masalah saat Anda menggunakan SDK .NET Azure Cosmos DB.
- Pelajari tentang panduan performa untuk .NET v3 dan .NET v2.
- Mendiagnosis dan memecahkan masalah saat Anda menggunakan Azure Cosmos DB Java v4 SDK.
- Pelajari tentang panduan performa untuk Java v4 SDK.