Delen via


Veelvoorkomende problemen in Azure DocumentDB oplossen

Deze handleiding is op maat gemaakt om u te helpen bij het oplossen van problemen die kunnen optreden bij het gebruik van Azure DocumentDB. De handleiding biedt oplossingen voor connectiviteitsproblemen, foutscenario's en optimalisatieproblemen, die praktische inzichten bieden om uw ervaring te verbeteren.

Opmerking

Houd er rekening mee dat deze oplossingen algemene richtlijnen zijn en mogelijk specifieke configuraties vereisen op basis van afzonderlijke situaties. Raadpleeg altijd de officiƫle documentatie en ondersteuningsbronnen voor de meest nauwkeurige en up-to-datumgegevens.

Veelvoorkomende fouten en oplossingen

Niet mogelijk om verbinding te maken met Azure DocumentDB - Time-out fout

Dit probleem kan optreden wanneer voor het cluster niet de juiste firewallregels zijn ingeschakeld. Als u toegang probeert te krijgen tot het cluster vanuit een niet-Azure IP-bereik, moet u extra firewallregels toevoegen. Raadpleeg beveiligingsopties en -functies - Azure DocumentDB voor gedetailleerde stappen. Firewallregels kunnen worden geconfigureerd in de netwerkinstelling van de portal voor het cluster. Opties zijn onder andere het toevoegen van een bekend IP-adres/bereik of het inschakelen van openbare IP-toegang.

Schermopname van de time-outfoutoplossing voor Azure DocumentDB.

Kan geen verbinding maken met DNSClient.DnsResponseException-fout

Connectiviteitsproblemen opsporen:

Windows-gebruiker:
PsPing werkt niet. Het gebruik van nslookup bevestigt de bereikbaarheid en detectie van clusters, wat aangeeft dat netwerkproblemen onwaarschijnlijk zijn.

Unix-gebruikers:
Voor socket-/netwerkgerelateerde uitzonderingen kunnen potentiƫle problemen met de netwerkverbinding de toepassing verhinderen een verbinding tot stand te brengen met het Mongo-API-eindpunt van Azure DocumentDB.

Volg deze stappen om de connectiviteit te controleren:

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

Als TCP-verbinding met poort 10260 mislukt, blokkeert een omgevingsfirewall mogelijk de Azure DocumentDB-verbinding. Schuif omlaag naar de onderkant van de pagina om een ondersteuningsticket in te dienen.

Controleer de verbindingsreeks:

Gebruik alleen de verbindingsreeks die is opgegeven in Azure Portal. Zorg ervoor dat het het mongodb+srv://-protocol bevat, omdat dit vereist is voor de juiste connectiviteit. Vermijd het gebruik van variaties of voorvoegsels zoals c. Als u problemen ondervindt met connectiviteit, deelt u de logboeken van de toepassing of het stuurprogramma aan de clientzijde voor foutopsporing door een ondersteuningsticket in te dienen.

Foutcodes

Deze tabel bevat foutcodes die door Azure DocumentDB worden geretourneerd om problemen te identificeren en op te lossen. Dit is ook handig voor het oplossen van problemen met behulp van diagnostische logboeken.

Foutcode Foutnaam
1 Interne fout
2 BadValue
5 GrafiekBevatCyclus
9 Parsing mislukt
14 TypeMismatch
15 Overflow
20 OngeldigeOperatie
23 AlreadyInitialized
26 NaamruimteNotFound
27 IndexNietGevonden
28 PadNietLevensvatbaar
31 RolNietGevonden
34 KanArrayNietAanvullen
40 ConflicterendeUpdateOperators
43 CursorNotFound
48 NamespaceExists
52 DollarPrefixedFieldName
53 CanNotBeTypeArray
54 NotSingleValueField
56 EmptyFieldName
57 DottedFieldName
61 ShardKeyNotFound
66 Onveranderbaar veld
67 KanIndexNietMaken
68 IndexAlreadyExists
72 OngeldigeOpties
73 InvalidNamespace
85 IndexOptionsConflict
86 IndexSleutelSpecificatiesConflict
111 NotExactValueField
115 OpdrachtNietOndersteund
118 NamespaceNotSharded
146 Geheugenlimiet Overschreden (ExceededMemoryLimit)
159 DuurOverloop
165 ViewDepthLimitOverschreden
166 CommandNotSupportedOnView
167 OptieNietOndersteundOpWeergave
181 AmbiguousIndexKeyPattern
197 OptieOngeldigeIndexSpecificatie
224 QueryfunctieNietToegestaan
232 MaxSubPipelineDepthExceeded
241 ConversionFailure
263 OperatieNietOndersteundInTransactie
276 IndexBuildAborted
291 KanIndexNietVinden
361 CollectieUUIDOnverenigbaarheid
10334 BsonObjectTooLarge
11000 DuplicateKey
12587 AchtergrondbewerkingBezigVoorNamespace
13113 MergeStageGeenOvereenkomendDocument
13297 DbAlreadyExists

Volgende stappen