Configurar a distribuição global do Azure Cosmos DB usando a API de TabelaSet up Azure Cosmos DB global distribution using the Table API

Este artigo aborda as seguintes tarefas:This article covers the following tasks:

  • Configurar a distribuição global usando o Portal do AzureConfigure global distribution using the Azure portal
  • Configurar a distribuição global usando a API de TabelaConfigure global distribution using the Table API

Adicionar regiões de banco de dados globais usando o Portal do AzureAdd global database regions using the Azure portal

O Azure Cosmos DB está disponível em todas as regiões do Azure pelo mundo.Azure Cosmos DB is available in all Azure regions worldwide. 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).After selecting the default consistency level for your database account, you can associate one or more regions (depending on your choice of default consistency level and global distribution needs).

  1. No Portal do Azure, na barra esquerda, clique em BD Cosmos do Azure.In the Azure portal, in the left bar, click Azure Cosmos DB.

  2. Na página do Azure Cosmos DB, selecione a conta do banco de dados a ser modificada.In the Azure Cosmos DB page, select the database account to modify.

  3. Na página da conta, clique em Replicar dados globalmente no menu.In the account page, click Replicate data globally from the menu.

  4. Na página Replicar dados globalmente, clicando nas regiões no mapa, selecione aquelas a serem adicionadas ou removidas e clique em Salvar.In the Replicate data globally page, select the regions to add or remove by clicking regions in the map, and then click Save. 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.There is a cost to adding regions, see the pricing page or the Distribute data globally with Azure Cosmos DB article for more information.

    Clicar nas regiões no mapa para adicioná-las ou removê-las

Depois de adicionar uma segunda região, a opção Failover Manual é habilitada na página Replicar dados globalmente no portal.Once you add a second region, the Manual Failover option is enabled on the Replicate data globally page in the portal. Você pode usar essa opção para testar o processo de failover ou alterar a região de gravação principal.You can use this option to test the failover process or change the primary write region. 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.Once you add a third region, the Failover Priorities option is enabled on the same page so that you can change the failover order for reads.

Selecionar regiões de bancos de dados globaisSelecting global database regions

Há dois cenários comuns para configurar duas ou mais regiões:There are two common scenarios for configuring two or more regions:

  1. Fornecimento de acesso a dados de baixa latência para os usuários finais, independentemente de onde estejam localizados em todo o mundoDelivering low-latency access to data to end users no matter where they are located around the globe
  2. Adição de resiliência regional para continuidade dos negócios e recuperação de desastre (BCDR)Adding regional resiliency for business continuity and disaster recovery (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.For delivering low-latency to end users, it is recommended that you deploy both the application and Azure Cosmos DB in the regions that correspond to where the application's users are located.

Para o BCDR, é recomendável adicionar regiões com base nos pares de regiões descritos no artigo BCDR (continuidade dos negócios e recuperação de desastres): Regiões combinadas do Azure.For BCDR, it is recommended to add regions based on the region pairs described in the Business continuity and disaster recovery (BCDR): Azure Paired Regions article.

Conectar-se a uma região preferencial usando a API de TabelaConnecting to a preferred region using the Table API

Para aproveitar a distribuição global, os aplicativos cliente podem especificar a lista de preferências ordenadas de regiões a serem usadas para executar operações de documento.In order to take advantage of global distribution, client applications can specify the ordered preference list of regions to be used to perform document operations. Isso pode ser feito configurando a propriedade TableConnectionPolicy.PreferredLocations.This can be done by setting the TableConnectionPolicy.PreferredLocations property. O SDK da API de Tabela do Azure Cosmos DB escolhe o melhor ponto de extremidade para se comunicar com base na configuração da conta, disponibilidade regional atual e na lista de preferência fornecida.The Azure Cosmos DB Table API SDK picks the best endpoint to communicate with based on the account configuration, current regional availability and the supplied preference list.

O PreferredLocations deve conter uma lista separada por vírgulas de locais (hospedagem múltipla) preferenciais para leituras.The PreferredLocations should contain a comma-separated list of preferred (multi-homing) locations for reads. Cada instância do cliente pode especificar um subconjunto dessas regiões na ordem preferida para leituras de baixa latência.Each client instance can specify a subset of these regions in the preferred order for low latency reads. As regiões devem ser nomeadas usando seus nomes de exibição, por exemplo, West US.The regions must be named using their display names, for example, West US.

Todas as leituras são enviadas para a primeira região disponível na lista PreferredLocations.All reads are sent to the first available region in the PreferredLocations list. Se a solicitação falhar, o cliente não fará o envio para a próxima região da lista, e assim por diante.If the request fails, the client will fail down the list to the next region, and so on.

Os SDKs tentam fazer a leitura de regiões especificadas na lista PreferredLocations.The SDK attempts to read from the regions specified in PreferredLocations. Desse modo, se a Conta do Banco de Dados estiver disponível em três regiões, por exemplo, mas o cliente especificar apenas duas das regiões de não gravação para PreferredLocations, nenhuma leitura será atendida fora da região de gravação, mesmo no caso de failover.So, for example, if the Database Account is available in three regions, but the client only specifies two of the non-write regions for PreferredLocations, then no reads will be served out of the write region, even in the case of failover.

O SDK envia automaticamente todas as gravações para a região de gravação atual.The SDK automatically sends all writes to the current write region.

Se a propriedade PreferredLocations não estiver definida, todas as solicitações serão atendidas na região de gravação atual.If the PreferredLocations property is not set, all requests will be served from the current write region.

Assim, concluímos este tutorial.That's it, that completes this tutorial. Aprenda a gerenciar a consistência de sua conta globalmente replicada lendo Níveis de consistência no Azure Cosmos DB.You can learn how to manage the consistency of your globally replicated account by reading Consistency levels in Azure Cosmos DB. E para saber mais sobre como a replicação de banco de dados global funciona no Azure Cosmos DB, veja Distribuir dados globalmente com o Azure Cosmos DB.And for more information about how global database replication works in Azure Cosmos DB, see Distribute data globally with Azure Cosmos DB.

Próximas etapasNext steps

Neste tutorial, você fez o seguinte:In this tutorial, you've done the following:

  • Configurar a distribuição global usando o Portal do AzureConfigure global distribution using the Azure portal
  • Configurar a distribuição global usando a API de Tabela Azure Cosmos DBConfigure global distribution using the Azure Cosmos DB Table APIs