Wereldwijde distributie met Azure Cosmos DB instellen met behulp van de Table-APISet up Azure Cosmos DB global distribution using the Table API

Dit artikel behandelt de volgende taken:This article covers the following tasks:

  • Wereldwijde distributie configureren met behulp van Azure PortalConfigure global distribution using the Azure portal
  • Globale distributie configureren met behulp van de Table-APIConfigure global distribution using the Table API

Globale databaseregio's toevoegen met Azure PortalAdd global database regions using the Azure portal

Azure Cosmos DB is wereldwijd beschikbaar in alle Azure-regio's.Azure Cosmos DB is available in all Azure regions worldwide. Nadat u het standaardconsistentieniveau voor uw databaseaccount hebt geselecteerd, kunt u een of meer regio's aan het account koppelen (afhankelijk van uw keuze van het standaardconsistentieniveau en behoeften voor globale distributie).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. Klik in Azure Portal in de linkerbalk op Azure Cosmos DB.In the Azure portal, in the left bar, click Azure Cosmos DB.

  2. Selecteer op de pagina Azure Cosmos DB het databaseaccount dat u wilt wijzigen.In the Azure Cosmos DB page, select the database account to modify.

  3. Klik op de accountpagina op Gegevens globaal repliceren in het menu.In the account page, click Replicate data globally from the menu.

  4. Selecteer op de pagina Gegevens globaal repliceren de regio's die u wilt toevoegen of verwijderen door op de kaart op regio's te klikken. Klik vervolgens op Opslaan.In the Replicate data globally page, select the regions to add or remove by clicking regions in the map, and then click Save. Er zijn kosten verbonden aan het toevoegen van regio's. Raadpleeg de pagina met prijzen of het artikel Gegevens globaal distribueren met Azure Cosmos DB voor meer informatie.There is a cost to adding regions, see the pricing page or the Distribute data globally with Azure Cosmos DB article for more information.

    Klik op de kaart op de regio's die u wilt toevoegen of verwijderen

Zodra u een tweede regio toevoegt, komt de optie Handmatige failover beschikbaar op de pagina Gegevens globaal repliceren in de portal.Once you add a second region, the Manual Failover option is enabled on the Replicate data globally page in the portal. Deze optie kunt u gebruiken om het failoverproces te testen of om de primaire regio voor schrijfbewerkingen te wijzigen.You can use this option to test the failover process or change the primary write region. Als u een derde regio toevoegt, komt op dezelfde pagina de optie Failoverprioriteiten beschikbaar. Hiermee kunt u de failovervolgorde voor leesbewerkingen wijzigen.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.

Globale databaseregio's selecterenSelecting global database regions

Er zijn twee gangbare scenario's voor het configureren van twee of meer regio's:There are two common scenarios for configuring two or more regions:

  1. Gegevenstoegang met lage latentie bieden aan eindgebruikers, ongeacht waar deze zich bevindenDelivering low-latency access to data to end users no matter where they are located around the globe
  2. Regionale tolerantie toevoegen voor bedrijfscontinuïteit en herstel na noodgevallen (BCDR)Adding regional resiliency for business continuity and disaster recovery (BCDR)

In het eerste geval wordt het aanbevolen om zowel de toepassing als Azure Cosmos DB te implementeren in de regio's die overeenkomen met de gebieden waar de gebruikers van de toepassing zich bevinden.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.

Voor BCDR wordt het aanbevolen om regio's toe te voegen op basis van de regioparen die worden beschreven in het artikel Bedrijfscontinuïteit en herstel na noodgevallen (BCDR): gekoppelde Azure-regio’s.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.

Verbinding maken met een voorkeursregio met behulp van de Table-APIConnecting to a preferred region using the Table API

Om gebruik te kunnen maken van de wereld wijde distributie, moeten client toepassingen de huidige locatie opgeven waar de toepassing wordt uitgevoerd.In order to take advantage of the global distribution, client applications should specify the current location where their application is running. Dit doet u door de CosmosExecutorConfiguration.CurrentRegion eigenschap in te stellen.This is done by setting the CosmosExecutorConfiguration.CurrentRegion property. De CurrentRegion eigenschap moet één locatie bevatten.The CurrentRegion property should contain a single location. Elk client exemplaar kan hun eigen regio opgeven voor lees bewerkingen met lage latentie.Each client instance can specify their own region for low latency reads. De naam van de regio moet worden opgegeven met behulp van hun weergave namen , zoals ' vs-West '.The region must be named by using their display names such as "West US".

De Azure Cosmos DB Table-API SDK kiest automatisch het beste eind punt om mee te communiceren op basis van de account configuratie en huidige regionale Beschik baarheid.The Azure Cosmos DB Table API SDK automatically picks the best endpoint to communicate with based on the account configuration and current regional availability. Dit geeft een prioriteit aan de dichtstbijzijnde regio voor betere latentie aan clients.It prioritizes the closest region to provide better latency to clients. Nadat u de huidige CurrentRegion eigenschap hebt ingesteld, worden lees-en schrijf aanvragen als volgt omgeleid:After you set the current CurrentRegion property, read and write requests are directed as follows:

  • Lees aanvragen: Alle Lees aanvragen worden verzonden naar de geconfigureerd CurrentRegion.Read requests: All read requests are sent to the configured CurrentRegion. Op basis van de nabijheid selecteert de SDK automatisch een geo-gerepliceerde terugval regio voor hoge Beschik baarheid.Based on the proximity, the SDK automatically selects a fallback geo-replicated region for high availability.

  • Schrijf aanvragen: De SDK verzendt alle schrijf aanvragen automatisch naar de huidige schrijf regio.Write requests: The SDK automatically sends all write requests to the current write region. In een multi master-account zullen de huidige regio ook de schrijf aanvragen verwerken.In a multi master account, current region will serve the writes requests as well. Op basis van de nabijheid selecteert de SDK automatisch een geo-gerepliceerde terugval regio voor hoge Beschik baarheid.Based on the proximity, the SDK automatically selects a fallback geo-replicated region for high availability.

Als u de CurrentRegion eigenschap niet opgeeft, gebruikt de SDK de huidige schrijf regio voor alle bewerkingen.If you don't specify the CurrentRegion property, the SDK uses the current write region for all operations.

Bijvoorbeeld, als een Azure Cosmos-account zich in regio's ' vs-West ' en ' vs-Oost ' bevindt.For example, if an Azure Cosmos account is in "West US" and "East US" regions. Als ' vs-West ' de schrijf regio is en de toepassing aanwezig is in ' vs-Oost '.If "West US" is the write region and the application is present in "East US". Als de eigenschap CurrentRegion niet is geconfigureerd, worden alle Lees-en schrijf aanvragen altijd doorgestuurd naar de regio vs-West.If the CurrentRegion property is not configured, all the read and write requests are always directed to the "West US" region. Als de eigenschap CurrentRegion is geconfigureerd, worden alle Lees aanvragen verzonden vanuit de regio VS-Oost.If the CurrentRegion property is configured, all the read requests are served from "East US" region.

Volgende stappenNext steps

In deze zelfstudie hebt u het volgende gedaan:In this tutorial, you've done the following:

  • Wereldwijde distributie configureren met behulp van Azure PortalConfigure global distribution using the Azure portal
  • Globale distributie met Azure Cosmos DB instellen met behulp van de Table-API’sConfigure global distribution using the Azure Cosmos DB Table APIs