Gerenciar a replicação entre regiões e a mesma região no cluster do Azure DocumentDB

O Azure DocumentDB permite streaming de dados contínuos para um cluster de réplica em outra região ou na mesma região do Azure. Essa funcionalidade oferece proteção de recuperação de desastres (DR) e escalabilidade de leitura entre as regiões e dentro da mesma região. Este documento serve como um guia rápido para desenvolvedores que desejam aprender a gerenciar a replicação para seus clusters.

Pré-requisitos

• Uma assinatura do Azure

  • Se você não tiver uma assinatura do Azure, crie uma conta gratuita

Habilitar a replicação entre regiões ou a mesma região

Você pode criar um cluster de réplica durante o novo provisionamento de cluster ou a qualquer momento em um cluster existente.

Criação de cluster de réplica durante o provisionamento de novo cluster

Para habilitar a replicação em um novo cluster durante a criação do cluster, siga estas etapas:

1. Siga as etapas para iniciar a criação do cluster e concluir a guia Noções básicas para um novo cluster do Azure DocumentDB.
2. (opcionalmente) Selecione as configurações de acesso à rede desejadas para o cluster na guia Rede.
3. Na guia Distribuição global, selecione a opção Habilitar para a Réplica de Cluster.
4. Forneça um nome de cluster de réplica no campo Nome da réplica de leitura.
5. Selecione uma região na região de réplica de leitura. O cluster de réplica é hospedado na região do Azure selecionada.
6. Na guia Examinar + criar, examine os detalhes da configuração de cluster e selecione Criar.

Criação de cluster de réplica para cluster existente

Para habilitar a replicação em um novo cluster a qualquer momento após a criação do cluster, siga estas etapas:

1. Siga as etapas para criar um novo cluster do Azure DocumentDB.
2. Ignore a guia Distribuição global. Essa guia é usada para criar uma réplica de cluster durante o provisionamento de cluster primário.
3. Depois que o cluster for criado, na barra lateral do cluster, em Configurações, selecione Distribuição Global.
4. Selecione Adicionar nova réplica de leitura.
5. Forneça um nome de cluster de réplica no campo Nome da réplica de leitura.
6. Selecione uma região na região de réplica de leitura. O cluster de réplica é hospedado na região do Azure selecionada.
7. (opcionalmente) Selecione a chave gerenciada pelo cliente na seção Criptografia de dados para habilitar a criptografia de dados com uma CMK (chave gerenciada pelo cliente) no cluster de réplica. Em seguida, siga as etapas para habilitar o CMK.
8. Verifique sua seleção e selecione o botão Salvar para confirmar a criação da réplica.

Para tornar o cluster de réplica acessível para operações de leitura, ajuste suas configurações de rede configurando regras de firewall para acesso público ou adicionando pontos de extremidade privados para acesso seguro e privado.

Promover uma réplica

Para promover uma réplica de cluster para um cluster de leitura/gravação, siga estas etapas:

1. Selecione a réplica de cluster que você deseja promover no portal.
2. Na barra lateral do cluster, em Configurações, selecione Distribuição global.
3. Na página Distribuição global, selecione Promover.
4. Na tela Promover <nome do cluster>, verifique duas vezes o nome da réplica do cluster, leia o texto de aviso e selecione Promover.

Depois que a réplica do cluster é promovida, ela se torna um cluster legível e gravável. Se a HA (alta disponibilidade) estiver habilitada no cluster primário (leitura/gravação), ela precisará ser habilitada novamente no cluster de réplica após a promoção.

Verificar a função de replicação de cluster e a região de replicação

Para verificar a função de replicação de um cluster, siga estas etapas:

1. Selecione um cluster existente do Azure DocumentDB.
2. Selecione a página de visão geral.
3. Verifique Região de leitura (no cluster primário) ou Região de gravação (no cluster de réplica).

Se o valor da região de leitura não estiver habilitado, esse cluster terá a replicação desabilitada.

Desabilitar a replicação entre regiões ou a mesma região

Para desabilitar a replicação, siga estas etapas:

1. Selecione o cluster de réplica do Azure DocumentDB.
2. Selecione Visão geral.
3. Confirme se é um cluster de réplica.
4. No portal do Azure, na página Visão geral para o cluster de réplica, selecione Excluir.
5. Na tela Excluir <nome da réplica>, leia o texto do aviso e insira o nome do cluster no campo Confirmar o nome da conta.
6. Selecione Excluir para confirmar a exclusão da réplica.

Se você precisar excluir os clusters primário e de réplica, precisará excluir o cluster de réplica primeiro.

Usar cadeias de conexão

Você pode se conectar à réplica do cluster como faria com um cluster de leitura/gravação regular. Siga estas etapas para obter as cadeias de conexão para diferentes casos:

1. Selecione o cluster primário ou sua réplica de cluster no portal.
2. Na barra lateral do cluster, em Configurações, selecione Cadeias de conexão.
3. Copie a cadeia de conexão do cluster selecionado no momento para se conectar a esse cluster.
4. (opcionalmente, somente no cluster primário) Copie a cadeia de conexão de leitura/gravação global que sempre aponta para o cluster disponível para gravações.

As cadeias de conexão são preservadas após a promoção de réplica de cluster. Você pode continuar a usar a cadeia de caracteres ou a cadeia de conexão de leitura/gravação global para operações de leitura. Se você usar a cadeia de conexão autônoma para operações de gravação, precisará atualizar a cadeia de conexão em seu aplicativo para apontar para o cluster de réplica promovido para continuar gravações no banco de dados após a conclusão da promoção.

Conteúdo relacionado

• Saiba mais sobre a replicação entre regiões e a mesma região no Azure DocumentDB
• Confira os limites e limitações de replicação
• Para resolver um problema com a replicação, consulte este guia de solução de problemas.
• Saiba mais sobre confiabilidade no Azure DocumentDB