Solución de errores habituales del núcleo virtual de Azure Cosmos DB for MongoDB

SE APLICA A: núcleo virtual de MongoDB

Esta guía está diseñada para ayudarle a resolver los problemas que pueda encontrar al utilizar el núcleo virtual de Azure Cosmos DB for MongoDB. La guía ofrece soluciones para problemas de conectividad, escenarios de error y desafíos de optimización, ofreciendo información práctica para mejorar su experiencia.

Nota:

Tenga en cuenta que estas soluciones son directrices generales y pueden requerir configuraciones específicas basadas en situaciones individuales. Consulte siempre la documentación oficial y los recursos de soporte técnico para obtener la información más precisa y actualizada.

Errores habituales y soluciones

No se puede conectar al núcleo virtual de Azure Cosmos DB for MongoDB: error de tiempo de espera

Este problema puede producirse cuando el clúster no tiene habilitadas las reglas de firewall correctas. Si intenta acceder al clúster desde un intervalo IP que no es de Azure, debe agregar reglas de firewall adicionales. Consulte Opciones y características de seguridad: Núcleo virtual de Azure Cosmos DB for MongoDB para ver los pasos detallados. Las reglas de firewall se pueden configurar en la opción Redes del portal para el clúster. Entre las opciones se incluyen agregar un intervalo o dirección IP conocidos o habilitar el acceso de dirección IP pública.

No se puede conectar con el error DNSClient.DnsResponseException

Depurar problemas de conectividad:

Usuario de Windows:
PsPing no funciona. El uso de nslookup confirma la accesibilidad y la detectabilidad del clúster, lo que indica que es poco probable que se produzcan problemas de red.

Usuarios de Unix:
En el caso de las excepciones relacionadas con sockets o redes, es posible que haya problemas de conectividad de red que impidan que la aplicación establezca una conexión con el punto de conexión de la API Azure Cosmos DB Mongo.

Para comprobar la conectividad, siga estos pasos:

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

Si se produce un error en la conexión de TCP al puerto 10260, es posible que un firewall del entorno bloquee la conexión de Azure Cosmos DB. Desplácese hacia abajo hasta la parte inferior de la página para enviar una incidencia de soporte técnico.

Compruebe la cadena de conexión:

Use solo la cadena de conexión proporcionada en Azure Portal. Asegúrese de que incluye el protocolo mongodb+srv://, ya que esto es necesario para una conectividad adecuada. Evite usar variaciones o prefijos como c. Si tiene problemas con la conectividad, comparta los registros de la aplicación o del controlador del lado cliente para la depuración mediante el envío de una incidencia de soporte técnico.

Códigos de error

En esta tabla se enumeran los códigos de error devueltos por Azure Cosmos DB para el núcleo virtual de MongoDB para ayudar a identificar y resolver problemas. También son útiles para solucionar problemas mediante registros de diagnóstico.

Código de error	Nombre del error
1	Error interno
2	BadValue
5	GraphContainsCycle
9	FailedToParse
14	TypeMismatch
15	Desbordamiento
20	IllegalOperation
23	Ya inicializado
26	NamespaceNotFound
27	IndexNotFound
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	No se puede crear el índice
68	ÍndiceYaExiste
72	InvalidOptions
73	InvalidNamespace
85	IndexOptionsConflict
86	IndexKeySpecsConflict
111	NotExactValueField
115	CommandNotSupported
118	NamespaceNotSharded
146	Límite de Memoria Excedido
159	DurationOverflow
165	ViewDepthLimitExceeded
166	CommandNotSupportedOnView
167	OpciónNoSoportadaEnVista
181	AmbiguousIndexKeyPattern
197	InvalidIndexSpecificationOption
224	QueryFeatureNotAllowed
232	MaxSubPipelineDepthExceeded
241	ConversionFailure
263	OperationNotSupportedInTransaction
276	IndexBuildAborted
291	NoSePuedeEncontrarÍndice
361	CollectionUUIDMismatch
10334	BsonObjectTooLarge
11 000	DuplicateKey
12587	BackgroundOperationInProgressForNamespace
13,113	MergeStageNoMatchingDocument
13297	DbAlreadyExists

Pasos siguientes

• Si ha seguido todos los pasos de solución de problemas y todavía no puede resolver el problema, puede abrir una solicitud de soporte técnico para obtener más ayuda.
• Si va a solucionar problemas de replicación entre regiones, consulte guía de solución de problemas para la replicación entre regiones.