Resolver problemas comuns no Azure DocumentDB

Este guia foi adaptado para o ajudar a resolver problemas que possa encontrar ao utilizar o Azure DocumentDB. O guia apresenta soluções para problemas de conectividade, cenários de erro e desafios de otimização, oferecendo insights práticos para melhorar a sua experiência.

Erros e soluções comuns

Não é possível ligar-se ao Azure DocumentDB - Erro de tempo limite

Este problema pode ocorrer quando o cluster não tem a(s) regra(s) correta(s) de firewall ativadas. Se estiveres a tentar aceder ao cluster a partir de um intervalo de IP que não seja Azure, precisas de adicionar regras extra de firewall. Consulte opções e funcionalidades de segurança - Azure DocumentDB para passos detalhados. As regras de firewall podem ser configuradas na definição de Rede do portal para o cluster. As opções incluem adicionar um endereço/intervalo IP conhecido ou ativar o acesso a IP público.

Não é possível ligar-se com DNSClient.DnsResponseException Erro

Depuração de Problemas de Conectividade

Utilizador Windows:
O PsPing não funciona. A utilização do nslookup confirma a acessibilidade e descoberta do cluster, indicando que os problemas de rede são improváveis.

Utilizadores Unix:
Para exceções relacionadas com Socket/Rede, potenciais problemas de conectividade de rede podem estar a dificultar a aplicação de estabelecer uma ligação com o endpoint da API Mongo do Azure DocumentDB.

Para verificar a conectividade, siga estes passos:

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

Se a ligação TCP à porta 10260 falhar, um firewall de ambiente pode estar a bloquear a ligação ao Azure DocumentDB. Por favor, desça até ao final da página para submeter um pedido de suporte.

Verifique a sua cadeia de ligação:

Usa apenas a string de ligação fornecida no portal Azure. Certifique-se de que inclui o protocolo mongodb+srv://, pois é necessário para uma conectividade adequada. Evite utilizar quaisquer variações ou prefixos tal como c. Se encontrar problemas com a conectividade, partilhe os registos de drivers da aplicação ou do lado do cliente para depuração submetendo um pedido de suporte.

Códigos de erro

Esta tabela lista códigos de erro devolvidos pelo Azure DocumentDB para ajudar a identificar e resolver problemas. Estes também são úteis para resolver problemas usando registos de diagnóstico.

Próximos passos

• Se você seguiu todas as etapas de solução de problemas e ainda não conseguiu resolver o problema, poderá abrir uma solicitação de suporte para obter mais assistência.
• Se estiveres a tentar resolver problemas de replicação entre regiões, consulta o guia de resolução de problemas para replicação entre regiões.