Řešení běžných problémů v Azure DocumentDB

Tato příručka je přizpůsobená tak, aby vám pomohla při řešení problémů, se kterými se můžete setkat při používání Azure DocumentDB. Tato příručka poskytuje řešení problémů s připojením, chybových scénářů a problémů s optimalizací a nabízí praktické přehledy pro zlepšení vašich zkušeností.

Poznámka:

Upozorňujeme, že tato řešení jsou obecná pravidla a mohou vyžadovat konkrétní konfigurace na základě jednotlivých situací. Vždy se seznamte s oficiální dokumentací a podpůrnými zdroji, abyste získali nejpřesnější a aktuální informace.

Běžné chyby a řešení

Nejde se připojit k Azure DocumentDB – chyba časového limitu

K tomuto problému může dojít v případě, že cluster nemá povolené správná pravidla brány firewall. Pokud se pokoušíte získat přístup ke clusteru z rozsahu IP adres mimo Azure, musíte přidat další pravidla brány firewall. Podrobné kroky najdete v tématu Možnosti a funkce zabezpečení – Azure DocumentDB . Pravidla brány firewall je možné nakonfigurovat v nastavení sítě portálu pro cluster. Mezi možnosti patří přidání známé IP adresy nebo rozsahu ip adres nebo povolení přístupu k veřejné IP adrese.

Nelze se připojit kvůli chybě DNSClient.DnsResponseException

Ladění problémů s připojením:

Uživatel Windows:
PsPing nefunguje. Použití nástroje nslookup potvrzuje dostupnost a zjistitelnost clusteru, což značí, že problémy se sítí nejsou pravděpodobné.

Uživatelé unixu:
U výjimek souvisejících se soketem nebo sítí můžou potenciální problémy s připojením k síti bránit aplikaci v navazování připojení ke koncovému bodu rozhraní Mongo API služby Azure DocumentDB.

Pokud chcete zkontrolovat připojení, postupujte takto:

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

Pokud připojení TCP k portu 10260 selže, brána firewall prostředí může blokovat připojení Azure DocumentDB. Prosím, posuňte se dolů na spodní část stránky a odešlete lístek podpory.

Ověřte připojovací řetězec:

Použijte pouze připojovací řetězec zadaný na webu Azure Portal. Ujistěte se, že obsahuje protokol mongodb+srv:// , protože se vyžaduje pro správné připojení. Vyhněte se používání jakýchkoli variant nebo předpon, jako je c. Pokud narazíte na problémy s připojením, sdílejte protokoly z ovladačů na straně aplikace nebo klienta pro ladění odesláním tiketu podpory.

Kódy chyb

Tato tabulka obsahuje kódy chyb vrácené službou Azure DocumentDB, které vám pomůžou identifikovat a vyřešit problémy. Tyto informace jsou užitečné také při řešení potíží s využitím diagnostických protokolů.

Kód chyby	Název chyby
1	Vnitřní chyba
2	BadValue
5	GrafObsahujeCyklus
9	Nepodařilo se analyzovat
14	TypeMismatch
15	Overflow
20	Neplatná operace
23	Již inicializováno
26	NamespaceNotFound
27	IndexNotFound
28	CestaNeníProveditelná
31	RoleNenalezena
34	NelzeDoplnitPole
40	ConflictingUpdateOperators
43	CursorNotFound
48	NamespaceExists
52	DollarPrefixedFieldName
53	CanNotBeTypeArray
54	NotSingleValueField
56	PrázdnýNázevPoložky
57	DottedFieldName
61	ShardKeyNotFound
66	Neměnné pole
67	NelzeVytvořitIndex
68	IndexJižExistuje
72	NeplatnéMožnosti
73	InvalidNamespace
85	KonfliktNastaveníIndexu
86	IndexKeySpecsConflict
111	NotExactValueField
115	PříkazNeníPodporován
118	NamespaceNotSharded
146	PřekročenLimitPaměti
159	DurationOverflow
165	ViewDepthLimitPřekročeno
166	Příkaz není podporován v zobrazení
167	MožnostNepodporovanáProZobrazení
181	AmbiguousIndexKeyPattern
197	NeplatnáMožnostSpecifikaceIndexu
224	DotazováníFunkceNeníPovoleno
232	Překročena maximální hloubka podprocesu
241	Převod – chyba
263	OperaceNepodporovánaVTransakci
276	PřerušeníStavbyIndexu
291	UnableToFindIndex
361	CollectionUUIDMismatch
10334	Bson objekt je příliš velký
11000	DuplicitníKlíč
12587	Operace na pozadí probíhá pro prostor názvů
13113	MergeStageNoMatchingDocument
13297	DbAlreadyExists

Další kroky

• Pokud jste postupovali podle všech kroků pro řešení potíží a stále nemůžete problém vyřešit, můžete otevřít žádost o podporu pro další pomoc.
• Pokud řešíte potíže s replikací mezi oblastmi, přečtěte si průvodce odstraňováním potíží pro replikaci mezi oblastmi.