Configurar a distribuição global do Azure Cosmos DB usando a API de Tabela
APLICA-SE AO: Table
Este artigo aborda as seguintes tarefas:
- Configurar a distribuição global usando o Portal do Azure
- Configurar a distribuição global usando a API de Tabela
Adicionar regiões de banco de dados globais usando o Portal do Azure
O Azure Cosmos DB está disponível em todas as regiões do Azure pelo mundo. Após a seleção do nível de consistência padrão para sua conta de banco de dados, você pode associar uma ou mais regiões (dependendo da sua escolha do nível de consistência padrão e das necessidades de distribuição global).
No Portal do Azure, na barra esquerda, clique em BD Cosmos do Azure.
Na página do Azure Cosmos DB, selecione a conta do banco de dados a ser modificada.
Na página da conta, clique em Replicar dados globalmente no menu.
Na página Replicar dados globalmente, clicando nas regiões no mapa, selecione aquelas a serem adicionadas ou removidas e clique em Salvar. Há um custo para adicionar regiões. Veja a página de preços ou o artigo Distribuir dados globalmente com o Azure Cosmos DB para obter mais informações.
Depois de adicionar uma segunda região, a opção Failover Manual é habilitada na página Replicar dados globalmente no portal. Você pode usar essa opção para testar o processo de failover ou alterar a região de gravação principal. Depois de adicionar uma terceira região, a opção Prioridades de Failover é habilitada na mesma página para que você possa alterar a ordem de failover das leituras.
Selecionar regiões de bancos de dados globais
Há dois cenários comuns para configurar duas ou mais regiões:
- Fornecimento de acesso a dados de baixa latência para os usuários finais, independentemente de onde estejam localizados em todo o mundo
- Adição de resiliência regional para continuidade dos negócios e recuperação de desastres (BCDR)
Para oferecer baixa latência para os usuários finais, é recomendável implantar o aplicativo e o Azure Cosmos DB nas regiões que correspondem aos locais em que os usuários do aplicativo estão localizados.
Para o BCDR, é recomendável adicionar regiões com base nos pares de regiões descritos no artigo Continuidade dos negócios e recuperação de desastre (BCDR): Regiões Emparelhadas do Azure.
Conectar-se a uma região preferencial usando a API de Tabela
Para aproveitar a distribuição global, os aplicativos cliente devem especificar a localização atual em que o aplicativo deles está em execução. Isso é feito definindo a propriedade CosmosExecutorConfiguration.CurrentRegion
. A propriedade CurrentRegion
deve conter uma localização. Cada instância de cliente pode especificar a própria região para leituras de baixa latência. A região deve ser nomeada usando os nomes de exibição como "Oeste dos EUA".
O SDK do Azure Cosmos DB for Table escolhe automaticamente o melhor ponto de extremidade para se comunicar com base na configuração da conta e na disponibilidade regional atual. Ele prioriza a região mais próxima para fornecer uma melhor latência aos clientes. Após definir a propriedade CurrentRegion
atual, as solicitações de leitura e gravação são direcionadas da seguinte maneira:
Solicitações de leitura: todas as solicitações de leitura são enviadas para o
CurrentRegion
configurado. Com base na proximidade, o SDK seleciona automaticamente uma região com replicação geográfica de fallback para alta disponibilidade.Solicitações de gravação: o SDK envia automaticamente todas as solicitações de gravação para a região de gravação atual. Em uma conta de gravação em várias regiões, a região atual também atenderá às solicitações de gravação. Com base na proximidade, o SDK seleciona automaticamente uma região com replicação geográfica de fallback para alta disponibilidade.
Se você não especificar a propriedade CurrentRegion
, o SDK usará a região de gravação atual para todas as operações.
Por exemplo, se uma conta do Azure Cosmos DB estiver nas regiões "Oeste dos EUA" e "Leste dos EUA". Se "Oeste dos EUA" for a região de gravação e o aplicativo estiver presente no "Leste dos EUA". Se a propriedade CurrentRegion não estiver configurada, todas as solicitações de leitura e gravação serão sempre direcionadas à região "Oeste dos EUA". Se a propriedade CurrentRegion estiver configurada, todas as solicitações de leitura serão atendidas da região "Leste dos EUA".
Próximas etapas
Neste tutorial, você fez o seguinte:
- Configurar a distribuição global usando o Portal do Azure
- Configurar a distribuição global usando a API de Tabela Azure Cosmos DB