Guia de solução de problemas: replicação entre regiões e a mesma região no Azure DocumentDB

Este guia foi projetado para ajudá-lo a solucionar problemas comuns ao usar a replicação de cluster com o Azure DocumentDB. Ele oferece soluções práticas para problemas de conectividade e desafios de otimização para melhorar sua experiência.

Problemas comuns e soluções

Meus dados não parecem ser replicados no cluster de réplica.

Verifique se seu cluster possui uma réplica criada. Um cluster de réplica pode ser criado durante o provisionamento inicial do cluster ou adicionado posteriormente. Você pode verificar a existência de uma réplica na página "Visão geral" ou criar uma nova na página "Distribuição global" do cluster no portal do Azure.

Não consigo encontrar a cadeia de conexão para o cluster de réplica.

O cluster de réplica é uma réplica completa do cluster primário com gravações desabilitadas. Ele é representado como um recurso de cluster separado no Azure e tem sua própria cadeia de conexão.

Para localizar o cluster de réplica:

• Abra a página de propriedades do cluster primário no portal do Azure.
• Navegue até a página "Distribuição global" e clique no nome com hiperlink do cluster de réplica.
• Nas propriedades do cluster de réplica, navegue até a página "Cadeias de conexão" para copiar a cadeia de conexão.

Não consigo me conectar ao cluster de réplica.

Verifique se o acesso público ou privado está habilitado para o cluster de réplica. Quando um cluster de réplica é criado em outra região, suas configurações de rede não são replicadas automaticamente do cluster principal do Azure DocumentDB.

Para habilitar o acesso:

• Para permitir o acesso público, adicione regras de firewall.
• Como alternativa, crie pontos de extremidade privados para habilitar o acesso privado ao cluster de réplica.

Como posso controlar a utilização de vários recursos, como memória ou IOPS em meu cluster de réplica?

Como o cluster de réplica é uma réplica completa do cluster principal do Azure DocumentDB, ele tem suas próprias métricas para monitorar o consumo de recursos.

Para exibir métricas:

1. Abra a página de propriedades do cluster de réplica no portal do Azure.
2. Navegue até a página Métricas para acessar e examinar os detalhes de consumo de recursos.

Veja orientações mais detalhadas sobre como usar métricas com o Azure DocumentDB nesta página.

Como posso abrir o cluster de réplica em outra região para gravações?

Você pode promover o cluster de réplica para se tornar um cluster de leitura e gravação a qualquer momento. Quando você promove o cluster de réplica na região B, o cluster ex-primário na região A é definido para o modo somente leitura, tornando-o efetivamente o cluster de réplica para o cluster primário recém-promovido.

Para promover o cluster de réplica:

1. Abra a página de propriedades do cluster de réplica no portal do Azure.
2. Navegue até a página Distribuição global.
3. Selecione Promover e confirme a promoção.

Durante o processo de promoção, a cadeia de conexão global de leitura e gravação é atualizada para apontar para o cluster de réplica recém-promovido, uma vez que ele esteja aberto para operações de gravação.

O cluster de réplica não é mais necessário. Como posso desabilitar a replicação e excluir o cluster de réplica?

Você pode excluir um cluster de réplica a qualquer momento sem afetar o cluster primário ou os dados armazenados e gravados nele. No entanto, se você precisar excluir os clusters de réplica e primário, certifique-se de que o cluster de réplica seja excluído primeiro.

Para excluir um cluster de réplica:

1. Abra a página de propriedades do cluster de réplica no portal do Azure.
2. Na página Visão Geral, selecione Excluir na barra de ferramentas.
3. Leia cuidadosamente a mensagem de aviso e confirme a exclusão.

Próximas etapas

• Se você seguiu todas as etapas de solução de problemas e ainda não conseguiu resolver o problema, abra uma solicitação de suporte para obter mais assistência.
• Se você estiver solucionando problemas comuns com o Azure DocumentDB, consulte este guia de solução de problemas.