Partilhar via


Gerir replicação entre regiões e na mesma região no seu cluster Azure DocumentDB

O Azure DocumentDB permite fluxo contínuo de dados para um cluster réplica noutra ou na mesma região Azure. Esse recurso fornece proteção de recuperação de desastres (DR) em várias regiões e escalabilidade de leitura tanto entre as regiões quanto 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

Habilite a replicação entre regiões ou na 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 um novo cluster

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

  1. Siga os passos para iniciar a criação do cluster e complete o separador Basics 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 Habilitar para a réplica de cluster.
  4. Forneça um nome de cluster de réplica no campo Ler nome da réplica.
  5. Selecione uma região na Região da réplica de leitura. O cluster de réplica é hospedado na região selecionada do Azure.
  6. No separador Rever + criar, reveja os detalhes da configuração do cluster e, em seguida, selecione Criar.

Observação

O cluster de réplica é criado na mesma assinatura do Azure e no mesmo grupo de recursos do que o seu cluster principal.

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 os passos para criar um novo cluster Azure DocumentDB.
  2. Ignorar o separador Global de Distribuição. Este separador é utilizado para criar uma réplica de cluster durante o provisionamento do 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 Ler nome da réplica.
  6. Selecione uma região na Região da réplica de leitura. O cluster de réplica é hospedado na região selecionada do Azure.
  7. (opcionalmente) Selecione Chave gerenciada pelo cliente na seção Criptografia de dados para habilitar a criptografia de dados com uma chave gerenciada pelo cliente (CMK) no cluster de réplica. Em seguida, siga as etapas para ativar a 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 transformar uma réplica de cluster num cluster de leitura-gravação, siga estas etapas:

  1. Selecione a réplica de cluster que você gostaria de 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. No ecrã Promover <nome do cluster>, verifique 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 alta disponibilidade (HA) estiver habilitada no cluster primário (leitura-gravação), ela precisará ser reativada 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 Azure DocumentDB existente.
  2. Selecione a página Visão geral .
  3. Verifique o valor da região de leitura (no cluster primário) ou da região de escrita (no cluster de réplica).

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

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

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

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

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

Utilizar as cadeias de ligação

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

  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 pessoal do cluster selecionado no momento para se conectar a esse cluster.
  4. (opcionalmente, apenas no cluster primário) Copie a cadeia de conexão global de leitura-gravação que sempre aponta para o cluster disponível para gravações.

Captura de ecrã das cadeias de ligação do cluster de um cluster Azure DocumentDB, incluindo a cadeia de ligação global para leitura e escrita e a cadeia de ligação própria.

As cadeias de caracteres de autoconexão são preservadas após a promoção da réplica do cluster. Você pode continuar a usar a cadeia de caracteres ou a cadeia de conexão global de leitura-gravação para operações de leitura. Se você usar a cadeia de conexão automática 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 as gravações no banco de dados após a conclusão da promoção.