Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Ce guide est adapté pour vous aider à résoudre les problèmes que vous pouvez rencontrer lors de l’utilisation d’Azure DocumentDB. Le guide fournit des solutions pour les problèmes de connectivité, les scénarios d’erreur et les défis d’optimisation, offrant des insights pratiques pour améliorer votre expérience.
Note
Notez que ces solutions sont des instructions générales et peuvent nécessiter des configurations spécifiques en fonction de situations individuelles. Reportez-vous toujours à la documentation officielle et aux ressources de support pour obtenir les informations les plus précises et les up-to-date.
Erreurs courantes et solutions
Connexion impossible à Azure DocumentDB - Erreur de timeout
Ce problème peut se produire lorsque le cluster n’a pas la ou les règles de pare-feu appropriées activées. Si vous essayez d’accéder au cluster à partir d’une plage d’adresses IP non Azure, vous devez ajouter des règles de pare-feu supplémentaires. Reportez-vous aux options et fonctionnalités de sécurité - Azure DocumentDB pour obtenir des étapes détaillées. Les règles de pare-feu peuvent être configurées dans le paramètre Réseau du portail pour le cluster. Les options incluent l’ajout d’une adresse IP/plage connue ou l’activation de l’accès IP public.
Impossible de se connecter à DNSClient.DnsResponseException, erreur
Débogage des problèmes de connectivité :
Utilisateur Windows :
PsPing ne fonctionne pas. L’utilisation de nslookup confirme l’accessibilité du cluster et la détectabilité, ce qui indique que les problèmes réseau sont peu probables.
Utilisateurs Unix :
Pour les exceptions liées au socket/réseau, les problèmes de connectivité réseau potentiels peuvent empêcher l’application d’établir une connexion avec le point de terminaison de l’API Mongo Azure DocumentDB.
Pour vérifier la connectivité, procédez comme suit :
nc -v <accountName>.mongocluster.cosmos.azure.com 10260
Si la connexion TCP au port 10260 échoue, un pare-feu d’environnement peut bloquer la connexion Azure DocumentDB. Faites défiler vers le bas jusqu'en bas de la page pour envoyer un ticket d'assistance.
Vérifiez votre chaîne de connexion :
Utilisez uniquement la chaîne de connexion fournie dans le portail Azure. Assurez-vous qu’il inclut le protocole mongodb+srv ://, car cela est nécessaire pour une connectivité appropriée. Évitez d’utiliser des variantes ou des préfixes tels que c. Si vous rencontrez des problèmes de connectivité, partagez les journaux de l’application ou du pilote côté client pour le débogage suite à l’envoi d’un ticket de support.
Codes d’erreur
Ce tableau répertorie les codes d’erreur retournés par Azure DocumentDB pour aider à identifier et résoudre les problèmes. Elles sont également utiles pour résoudre les problèmes liés à l’utilisation des journaux de diagnostic.
| Code d’erreur | Nom de l’erreur |
|---|---|
| 1 | Erreur Interne |
| 2 | BadValue |
| 5 | GraphContainsCycle |
| 9 | Échec de l'analyse |
| 14 | TypeMismatch |
| 15 | Overflow |
| 20 | Opérationillégale |
| 23 | Déjà initialisé |
| 26 | NamespaceNotFound |
| 27 | IndexNonTrouvé |
| 28 | PathNotViable |
| 31 | RoleNotFound |
| 34 | CannotBackfillArray |
| 40 | ConflictingUpdateOperators |
| 43 | CursorNotFound |
| 48 | NamespaceExists |
| 52 | DollarPrefixedFieldName |
| 53 | CanNotBeTypeArray |
| 54 | NotSingleValueField |
| 56 | EmptyFieldName |
| 57 | DottedFieldName |
| 61 | ShardKeyNotFound |
| 66 | ImmutableField |
| 67 | ImpossibleDeCréerUnIndex |
| 68 | IndexAlreadyExists |
| 72 | InvalidOptions |
| 73 | InvalidNamespace |
| 85 | IndexOptionsConflict |
| 86 | IndexKeySpecsConflict |
| 111 | ChampValeurNonExacte |
| 115 | CommandNotSupported |
| 118 | NamespaceNotSharded |
| 146 | Limite de mémoire dépassée |
| 159 | DurationOverflow |
| 165 | LimiteDeProfondeurDeVueDépassée |
| 166 | CommandNotSupportedOnView |
| 167 | OptionNotSupportedOnView |
| 181 | AmbiguousIndexKeyPattern |
| 197 | InvalidIndexSpecificationOption |
| 224 | FonctionnalitéDeRequêteNonAutorisée |
| 232 | MaxSubPipelineDepthExceeded |
| 241 | Échec de conversion |
| 263 | OperationNotSupportedInTransaction |
| 276 | IndexBuildAborted |
| 291 | UnableToFindIndex |
| 361 | CollectionUUIDMismatch |
| 10334 | BsonObjectTooLarge |
| 11000 | DuplicateKey |
| 12587 | BackgroundOperationInProgressForNamespace |
| 13113 | MergeStageNoMatchingDocument |
| 13297 | DbAlreadyExists |
Étapes suivantes
- Si vous avez suivi toutes les étapes de résolution des problèmes et que vous ne pouvez toujours pas résoudre votre problème, vous pouvez ouvrir une demande de support afin d’obtenir une assistance supplémentaire.
- Si vous résolvez les problèmes de réplication inter-régions, consultez le guide de résolution des problèmes pour la réplication interrégion.