Azure DocumentDB'de sık karşılaşılan sorunları giderme

Bu kılavuz, Azure DocumentDB kullanırken karşılaşabileceğiniz sorunları çözmenize yardımcı olacak şekilde uyarlanmıştır. Bağlantı sorunları, hata senaryoları ve iyileştirme zorlukları için çözümler sunan kılavuz, deneyiminizi geliştirmek için pratik içgörüler sunar.

Uyarı

Bu çözümlerin genel yönergeler olduğunu ve tek tek durumlara göre belirli yapılandırmalar gerektirebileceğini lütfen unutmayın. En doğru ve güncel bilgiler için her zaman resmi belgelere ve destek kaynaklarına başvurunuz.

Yaygın hatalar ve çözümler

Azure DocumentDB'ye Bağlanılamıyor - Zaman Aşımı hatası

Kümede doğru güvenlik duvarı kuralları etkinleştirilmediğinde bu sorun oluşabilir. Kümeye Azure olmayan bir IP aralığından erişmeye çalışıyorsanız ek güvenlik duvarı kuralları eklemeniz gerekir. Ayrıntılı adımlar için Güvenlik seçenekleri ve özellikleri - Azure DocumentDB'ye bakın. Güvenlik duvarı kuralları, küme için portalın Ağ ayarında yapılandırılabilir. Seçenekler arasında bilinen bir IP adresi/aralığı ekleme veya genel IP erişimini etkinleştirme yer alır.

DNSClient.DnsResponseException Hatasıyla Bağlantı Kurulamıyor

Bağlantı Sorunlarının Hata Ayıklanması

Windows Kullanıcısı:
PsPing çalışmıyor. nslookup kullanımı, ağ sorunlarının olası olmaydığını gösteren küme erişilebilirliğini ve bulunabilirliğini onaylar.

Unix Kullanıcıları:
Soket/Ağ ile ilgili istisnalar için, olası ağ bağlantı sorunları uygulamanın Azure DocumentDB Mongo API uç noktasına bağlantı kurmasını engelleyebilir.

Bağlantıyı denetlemek için şu adımları izleyin:

nc -v <accountName>.mongocluster.cosmos.azure.com 10260

10260 numaralı bağlantı noktasına TCP bağlantısı başarısız olursa, bir ortam güvenlik duvarı Azure DocumentDB bağlantısını engelliyor olabilir. Destek bileti göndermek için sayfayı aşağı kaydırarak sayfanın en altına gelin.

Bağlantı dizenizi doğrulayın:

Yalnızca Azure portalında sağlanan bağlantı dizesini kullanın. Düzgün bağlantı için gerekli olduğundan mongodb+srv:// protokollerini içerdiğinden emin olun. Varyasyonları veya c gibi ön ekleri kullanmaktan kaçının. Bağlantıyla ilgili sorunlarla karşılaşırsanız, bir destek bileti göndererek hata ayıklama için uygulama veya istemci tarafı sürücü günlüklerini paylaşın.

Hata Kodları

Bu tabloda, sorunları tanımlamaya ve çözmeye yardımcı olmak için Azure DocumentDB tarafından döndürülen hata kodları listelenmektedir. Bunlar tanılama günlüklerini kullanarak sorunları gidermek için de yararlıdır.

Hata Kodu	Hata Adı
1	Dahili Hata
2	HatalıDeğer
5	GrafikDöngüİçerir
9	Ayrıştırma Başarısız
14	TürUyuşmazlığı
15	Overflow
20	Geçersiz İşlem
23	Zaten Başlatılmış
26	Namespace Bulunamadı
27	Index Bulunamadı
28	YolUygunDeğil
31	Rol bulunamadı
34	DiziGeriDoldurulamıyor
40	ÇakışanGüncellemeOperatörleri
43	CursorNotFound
48	NamespaceExists
52	DollarPrefixedFieldName
53	Tip Array Olamaz
54	NotSingleValueField
56	BoşAlanAdı
57	DottedFieldName
61	ShardKeyNotFound
66	Değiştirilemez Alan
67	Index oluşturulamadı
68	DizinZatenMevcut
72	Geçersiz Seçenekler
73	GeçersizAdAlanı
85	DizinSeçenekleriÇakışması
86	DizinAnahtarÖzellikleriÇatışması
111	NotExactValueField
115	KomutDesteklenmiyor
118	NamespaceNotSharded
146	Bellek Sınırı Aşıldı
159	Süre Aşımı
165	GörünümDerinlikLimitiAşıldı
166	KomutGörünümdeDesteklenmiyor
167	Görünümde Desteklenmeyen Seçenek
181	AmbiguousIndexKeyPattern
197	InvalidIndexSpecificationOption (Geçersiz Dizin Belirtim Seçeneği)
224	Sorgulama Özelliğine İzin Verilmiyor
232	Maksimum Alt Boru Hattı Derinliği Aşıldı
241	Dönüşüm Başarısızlığı
263	İşlem İşlemde Desteklenmiyor
276	DizinYapımıDurduruldu
291	IndexBulunamadı
361	KoleksiyonUUIDFarklılığı (CollectionUUIDMismatch)
10334	BsonObjectTooLarge
11000	Yinelenen Anahtar
12587	Ad Alanında Devam Eden Arka Plan İşlemi
13113	Belgele Eşleşmeyen Birleştirme Aşaması
13297	DbAlreadyExists

Sonraki Adımlar

• Tüm sorun giderme adımlarını izlediyseniz ve sorununuzu hala çözemiyorsanız, daha fazla yardım için bir destek isteği açabilirsiniz.
• Bölgeler arası çoğaltma sorunlarını gideriyorsanız bölgeler arası çoğaltma için sorun giderme kılavuzuna bakın.