Nastavení globální distribuce služby Azure Cosmos DB pomocí rozhraní Table APISet up Azure Cosmos DB global distribution using the Table API

Tento článek se zabývá následujícími úkony:This article covers the following tasks:

  • Konfigurace globální distribuce pomocí webu Azure PortalConfigure global distribution using the Azure portal
  • Konfigurace globální distribuce pomocí rozhraní Table APIConfigure global distribution using the Table API

Přidání globálních oblastí databáze pomocí webu Azure PortalAdd global database regions using the Azure portal

Azure Cosmos DB je k dispozici ve všech oblastech Azure po celém světě.Azure Cosmos DB is available in all Azure regions worldwide. Po výběru výchozí úrovně konzistence účtu databáze k němu můžete přidružit jednu nebo několik oblastí (v závislosti na výběru výchozí úrovně konzistence a potřebách globální distribuce).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. V levém panelu na webu Azure Portal klikněte na Azure Cosmos DB.In the Azure portal, in the left bar, click Azure Cosmos DB.

  2. Na stránce Azure Cosmos DB vyberte účet databáze, který chcete upravit.In the Azure Cosmos DB page, select the database account to modify.

  3. V nabídce na stránce účtu klikněte na Globální replikace dat.In the account page, click Replicate data globally from the menu.

  4. Na stránce Globální replikace dat vyberte kliknutím na oblasti na mapě oblasti, které chcete přidat nebo odebrat, a pak klikněte na Uložit.In the Replicate data globally page, select the regions to add or remove by clicking regions in the map, and then click Save. Za přidání oblastí se neúčtují žádné poplatky. Další informace najdete na stránce s cenami nebo v článku Globální distribuce dat pomocí služby Azure Cosmos DB.There is a cost to adding regions, see the pricing page or the Distribute data globally with Azure Cosmos DB article for more information.

    Přidání nebo odebrání oblastí kliknutím na oblasti na mapě

Po přidání druhé oblasti se na stránce portálu Globální replikace dat povolí možnost Ruční převzetí služeb při selhání.Once you add a second region, the Manual Failover option is enabled on the Replicate data globally page in the portal. Pomocí této možnosti můžete otestovat proces převzetí služeb při selhání nebo změnit primární oblast pro zápis.You can use this option to test the failover process or change the primary write region. Po přidání třetí oblasti se na stejné stránce povolí možnost Priority převzetí služeb při selhání, abyste mohli změnit pořadí převzetí služeb při selhání pro čtení.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.

Výběr globálních oblastí databázeSelecting global database regions

Pro konfiguraci dvou nebo více oblastí existují dva běžné scénáře:There are two common scenarios for configuring two or more regions:

  1. Poskytování přístupu k datům s nízkou latencí koncovým uživatelům po celém světe bez ohledu na to, kde se nacházejí.Delivering low-latency access to data to end users no matter where they are located around the globe
  2. Přidání oblastní odolnosti pro zajištění provozní kontinuity a zotavení po havárii (BCDR).Adding regional resiliency for business continuity and disaster recovery (BCDR)

Pro zajištění nízké latence pro koncové uživatele se doporučuje nasadit aplikaci i službu Azure Cosmos DB v oblastech, které odpovídají umístění uživatelů aplikace.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.

Pro zajištění BCDR se doporučuje přidat oblasti podle spárovaných oblastí popsaných v článku Provozní kontinuita a zotavení po havárii (BCDR): Spárované oblasti 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.

Připojení k preferované oblasti pomocí rozhraní Table APIConnecting to a preferred region using the Table API

Aby bylo možné využít globální distribuci, měly by klientské aplikace určovat aktuální umístění, ve kterém je aplikace spuštěná.In order to take advantage of the global distribution, client applications should specify the current location where their application is running. To se provádí nastavením CosmosExecutorConfiguration.CurrentRegion vlastnosti.This is done by setting the CosmosExecutorConfiguration.CurrentRegion property. CurrentRegion Vlastnost by měla obsahovat jedno umístění.The CurrentRegion property should contain a single location. Každá instance klienta může určit svou vlastní oblast pro čtení s nízkou latencí.Each client instance can specify their own region for low latency reads. Oblast musí být pojmenována pomocí zobrazovaných názvů , jako je například "západní USA".The region must be named by using their display names such as "West US".

Sada Azure Cosmos DB rozhraní API pro tabulky SDK automaticky vybere nejlepší koncový bod ke komunikaci s nástrojem na základě konfigurace účtu a aktuální regionální dostupnosti.The Azure Cosmos DB Table API SDK automatically picks the best endpoint to communicate with based on the account configuration and current regional availability. Přidělí prioritu nejbližší oblasti, aby poskytovala lepší latenci klientům.It prioritizes the closest region to provide better latency to clients. Po nastavení aktuální CurrentRegion vlastnosti jsou požadavky na čtení a zápis směrovány takto:After you set the current CurrentRegion property, read and write requests are directed as follows:

  • Žádosti o čtení: Všechny požadavky na čtení se odesílají do nakonfigurovaného CurrentRegion.Read requests: All read requests are sent to the configured CurrentRegion. Na základě blízkosti se sada SDK automaticky vybere jako záložní geograficky replikovaný region pro zajištění vysoké dostupnosti.Based on the proximity, the SDK automatically selects a fallback geo-replicated region for high availability.

  • Požadavky na zápis: Sada SDK automaticky pošle všechny požadavky na zápis do aktuální oblasti pro zápis.Write requests: The SDK automatically sends all write requests to the current write region. V rámci vícenásobného hlavního účtu budou aktuální oblasti sloužit i pro požadavky na zápis.In a multi master account, current region will serve the writes requests as well. Na základě blízkosti se sada SDK automaticky vybere jako záložní geograficky replikovaný region pro zajištění vysoké dostupnosti.Based on the proximity, the SDK automatically selects a fallback geo-replicated region for high availability.

Pokud CurrentRegion vlastnost nezadáte, použije sada SDK aktuální oblast zápisu pro všechny operace.If you don't specify the CurrentRegion property, the SDK uses the current write region for all operations.

Například pokud je účet Azure Cosmos v oblastech "Západní USA" a "Východní USA".For example, if an Azure Cosmos account is in "West US" and "East US" regions. Pokud je "Západní USA" oblast pro zápis a aplikace je k dispozici v "Východní USA".If "West US" is the write region and the application is present in "East US". Pokud vlastnost CurrentRegion není nakonfigurovaná, všechny požadavky na čtení a zápis se vždycky přesměrují do oblasti "Západní USA".If the CurrentRegion property is not configured, all the read and write requests are always directed to the "West US" region. Pokud je nakonfigurována vlastnost CurrentRegion, jsou všechny požadavky na čtení obsluhovány z oblasti "Východní USA".If the CurrentRegion property is configured, all the read requests are served from "East US" region.

Další krokyNext steps

V tomto kurzu jste provedli následující:In this tutorial, you've done the following:

  • Konfigurace globální distribuce pomocí webu Azure PortalConfigure global distribution using the Azure portal
  • Konfigurace globální distribuce pomocí rozhraní Table API služby Azure Cosmos DBConfigure global distribution using the Azure Cosmos DB Table APIs