Solución de problemas comunes en Azure DocumentDB

Esta guía está adaptada para ayudarle a resolver problemas que puede encontrar al usar Azure DocumentDB. La guía proporciona soluciones para problemas de conectividad, escenarios de error y desafíos de optimización, lo que ofrece información práctica para mejorar su experiencia.

Errores habituales y soluciones

No se puede conectar a Azure DocumentDB: 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: Azure DocumentDB para conocer los pasos detallados. Las reglas de firewall se pueden configurar en la configuración redes del portal para el clúster. Entre las opciones se incluyen agregar una dirección IP o un intervalo conocidos o habilitar el acceso a direcciones IP públicas.

No se puede conectar con DNSClient.DnsResponseException Error

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, los posibles problemas de conectividad de red podrían impedir que la aplicación establezca una conexión con el punto de conexión de Mongo API de Azure DocumentDB.

Para comprobar la conectividad, siga estos pasos:

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

Si se produce un error en la conexión TCP al puerto 10260, es posible que un firewall de entorno bloquee la conexión de Azure DocumentDB. 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 DocumentDB para ayudar a identificar y resolver problemas. También son útiles para solucionar problemas mediante registros de diagnóstico.

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 la guía de solución de problemas para la replicación entre regiones.