Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.
Observação
Por favor, note que estas soluções são diretrizes gerais e podem exigir configurações específicas com base em situações individuais. Consulte sempre a documentação oficial e os recursos de apoio para obter informações mais precisas e up-todatas.
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.
| Código de Erro | Nome do erro |
|---|---|
| 1 | Erro interno |
| 2 | MauValor |
| 5 | GrafoContémCiclo |
| 9 | Falha ao Analisar |
| 14 | TypeMismatch |
| 15 | Overflow |
| 20 | Operação Ilegal |
| 23 | Já Inicializado |
| 26 | NamespaceNotFound |
| 27 | ÍndiceNãoEncontrado |
| 28 | CaminhoNãoViável |
| 31 | FunçãoNãoEncontrada |
| 34 | Não é possível preencher o array |
| 40 | Operadores de Atualização Conflitantes |
| 43 | CursorNotFound |
| 48 | NamespaceExists |
| 52 | DollarPrefixedFieldName |
| 53 | Não pode ser do tipo Array |
| 54 | NotSingleValueField |
| 56 | Nome do Campo Vazio |
| 57 | Nome do CampoPontilhado |
| 61 | ShardKeyNotFound |
| 66 | ImutableField |
| 67 | NãoPodeCriarÍndice |
| 68 | IndexJáExiste |
| 72 | OpçõesInválidas |
| 73 | Namespace Inválido |
| 85 | ÍndiceOpçõesConflito |
| 86 | IndexKeySpecsConflict |
| 111 | CampoDeValorNãoExato |
| 115 | Comando Não Suportado |
| 118 | NamespaceNotSharded (Espaço de Nomes Não Fragmentado) |
| 146 | Limite de Memória Excedido |
| 159 | DuraçãoTransbordamento |
| 165 | ViewDepthLimitExceeded |
| 166 | ComandoNãoSuportadoNaVista |
| 167 | OpçãoNãoSuportadaNaVista |
| 181 | AmbiguousIndexKeyPattern |
| 197 | InvalidIndexSpecificationOption |
| 224 | Recurso de Consulta Não Permitido |
| 232 | MaxSubPipelineProfundidadeExcedida |
| 241 | Falha de Conversão |
| 263 | OperaçãoNãoSuportadaEmTransação |
| 276 | Construção do Índice Abortada |
| 291 | ÍndiceNãoEncontrado |
| 361 | CollectionUUIDMismatch |
| 10334 | BsonObjectoDemasiado Grande |
| 11000 | DuplicateKey |
| 12587 | ContextoOperaçãoEmProgressoParaEspaço dos Nomes |
| 13113 | FaseDeFusãoSemDocumentoCorrespondente |
| 13297 | DbAlreadyExists |
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.