Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Panduan ini disesuaikan untuk membantu Anda menyelesaikan masalah yang mungkin Anda temui saat menggunakan Azure DocumentDB. Panduan ini menyediakan solusi untuk masalah konektivitas, skenario kesalahan, dan tantangan pengoptimalan, menawarkan wawasan praktis untuk meningkatkan pengalaman Anda.
Nota
Harap dicatat bahwa solusi ini adalah pedoman umum dan mungkin memerlukan konfigurasi tertentu berdasarkan situasi individu. Selalu rujuk pada dokumentasi resmi dan sumber dukungan untuk informasi yang paling akurat dan terbaru.
Kesalahan dan solusi umum
Tidak dapat Menyambungkan ke Azure DocumentDB - Kesalahan Batas Waktu
Masalah ini mungkin terjadi ketika kluster tidak mengaktifkan aturan firewall yang benar. Jika Anda mencoba mengakses kluster dari rentang IP non-Azure, Anda perlu menambahkan aturan firewall tambahan. Lihat Opsi dan fitur keamanan - Azure DocumentDB untuk langkah-langkah terperinci. Aturan firewall dapat dikonfigurasi dalam pengaturan Jaringan portal untuk kluster. Opsi termasuk menambahkan alamat/rentang IP yang diketahui atau mengaktifkan akses IP publik.
Tidak Bisa Menghubungkan dengan Kesalahan DNSClient.DnsResponseException
Memecahkan Masalah Konektivitas:
Pengguna Windows:
PsPing tidak berfungsi. Penggunaan nslookup mengonfirmasi keterjangkauan dan penemuan kluster, menunjukkan masalah jaringan tidak mungkin terjadi.
Pengguna Unix:
Untuk pengecualian terkait Soket/Jaringan, potensi masalah konektivitas jaringan mungkin menghambat aplikasi untuk membuat koneksi dengan titik akhir Azure DocumentDB Mongo API.
Untuk memeriksa konektivitas, ikuti langkah-langkah berikut:
nc -v <accountName>.mongocluster.cosmos.azure.com 10260
Jika TCP tersambung ke port 10260 gagal, firewall lingkungan mungkin memblokir koneksi Azure DocumentDB. Silakan gulir ke bawah ke bagian bawah halaman untuk mengirimkan tiket dukungan.
Verifikasi string koneksi Anda:
Hanya gunakan string koneksi yang disediakan di portal Microsoft Azure. Pastikan protokol tersebut menyertakan protokol mongodb+srv://, karena ini diperlukan untuk konektivitas yang tepat. Hindari menggunakan variasi atau awalan seperti c. Jika Anda mengalami masalah dengan konektivitas, bagikan log aplikasi atau driver sisi klien untuk penelusuran kesalahan dengan mengirimkan tiket dukungan.
Kode Kesalahan
Tabel ini mencantumkan kode kesalahan yang dikembalikan oleh Azure DocumentDB untuk membantu mengidentifikasi dan mengatasi masalah. Ini juga berguna untuk memecahkan masalah menggunakan log diagnostik.
| Kode Kesalahan | Nama Kesalahan |
|---|---|
| 1 | Kesalahan Internal |
| 2 | Nilai Tidak Valid |
| 5 | GraphContainsCycle |
| 9 | Gagal Memproses |
| 14 | TypeMismatch |
| 15 | Luapan |
| 20 | Operasi Ilegal |
| 23 | Sudah Diinisialisasi |
| 26 | NamespaceNotFound |
| 27 | Kesalahan: Indeks Tidak Ditemukan (IndexNotFound) |
| 28 | JalurTidakLayak |
| 31 | PeranTidakDitemukan |
| 34 | TidakDapatMengisiUlangArray |
| 40 | Operator Pembaruan yang Bertentangan |
| 43 | CursorNotFound |
| 48 | NamespaceExists |
| 52 | DollarPrefixedFieldName |
| 53 | Tidak Dapat Menjadi Tipe Array |
| 54 | NotSingleValueField |
| 56 | EmptyFieldName |
| 57 | DottedFieldName |
| 61 | ShardKeyNotFound (Kunci Pecahan Tidak Ditemukan) |
| 66 | Ladang Tidak Dapat Diubah |
| 67 | Tidak Dapat Buat Indeks |
| 68 | IndeksSudahAda |
| 72 | OpsiTidakValid |
| 73 | NamespaceTidakValid |
| 85 | IndexOptionsConflict |
| 86 | KonflikSpesifikasiKunciIndeks |
| 111 | NotExactValueField |
| 115 | PerintahTidakDidukung |
| 118 | NamespaceNotSharded |
| 146 | MelebihiBatasMemori |
| 159 | DurasiBerlebih |
| 165 | Batas Kedalaman Tampilan Terlampaui |
| 166 | PerintahTidakDidukungPadaTampilan |
| 167 | OpsiTidakDidukungPadaTampilan |
| 181 | PolaKunciIndeksAmbigu |
| 197 | OpsiSpesifikasiIndeksTidakValid |
| 224 | PermintaanFiturTidakDiizinkan |
| 232 | MaxSubPipelineDepthExceeded |
| 241 | Kegagalan Konversi |
| 263 | OperasiTidakDidukungDalamTransaksi |
| 276 | PembangunanIndeksDibatalkan |
| 291 | Tidak Dapat Menemukan Indeks |
| 361 | KetidakcocokanUUIDKoleksi |
| 10334 | BsonObjectTooLarge |
| 11000 | DuplikatKey |
| 12587 | OperasiLatarBelakangSedangDiprosesUntukNamespace |
| 13113 | TahapPenggabunganDokumenTakCocok |
| 13297 | DbSudahAda |
Langkah selanjutnya
- Jika Anda mengikuti semua langkah pemecahan masalah dan masih tidak dapat mengatasi masalah Anda, Anda dapat membuka permintaan dukungan untuk bantuan lebih lanjut.
- Jika Anda memecahkan masalah replikasi lintas wilayah, lihat panduan pemecahan masalah untuk replikasi lintas wilayah.