Guia de resolução de problemas: Replicação entre regiões e na mesma região no Azure DocumentDB

Este guia foi concebido para o ajudar a resolver problemas comuns ao usar 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 e soluções comuns

Os meus dados não parecem estar a ser replicados para o cluster réplica.

Certifique-se de que o seu cluster tem uma réplica criada. Um cluster de réplica pode ser criado durante o provisionamento inicial do cluster ou adicionado posteriormente. Pode verificar a existência de uma réplica na página 'Visão Geral' ou criar uma nova na página de 'Distribuição Global' do seu cluster no portal Azure.

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

O cluster de réplica é uma réplica completa do cluster primário com operações de escrita desativadas. É representado como um recurso de cluster separado no Azure e tem a sua própria cadeia de ligação.

Para localizar o cluster de réplica:

• Abra a página de propriedades do cluster principal no portal Azure.
• Navegue até a página 'Distribuição global' e clique no nome com hiperlink do cluster de réplicas.
• 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 réplica é criado noutra região, as suas definições de rede não são replicadas automaticamente a partir 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 acompanhar a utilização de vários recursos, como memória ou IOPS, no meu cluster de réplica?

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

Para visualizar 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 revisar os detalhes de consumo de recursos.

Consulte 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 operações de escrita?

Você pode promover o cluster de réplica a qualquer momento para se tornar um cluster de leitura e escrita. Quando você promove o cluster de réplica na região B, o cluster ex-primário na região A é definido como 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é à página Distribuição global.
3. Selecione Promover e confirme a promoção.

Durante o processo de promoção, a string de conexão global de leitura e escrita é atualizada para apontar para o cluster de réplica recém-promovido assim que estiver aberto para escrita.

O cluster de réplica não é mais necessário. Como posso desativar 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ários, certifique-se de que o cluster de réplica seja excluído primeiro.

Para eliminar 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 atentamente a mensagem de aviso e confirme a eliminação.

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 está a resolver problemas comuns com o Azure DocumentDB, consulte este guia de resolução de problemas.