Konfigurowanie dystrybucji globalnej usługi Azure Cosmos DB przy użyciu interfejsu API tabelSet up Azure Cosmos DB global distribution using the Table API

W tym artykule opisano następujące zadania:This article covers the following tasks:

  • Konfigurowanie dystrybucji globalnej przy użyciu witryny Azure PortalConfigure global distribution using the Azure portal
  • Konfigurowanie dystrybucji globalnej przy użyciu interfejsów API tabelConfigure global distribution using the Table API

Dodawanie regionów globalnej bazy danych przy użyciu witryny Azure PortalAdd global database regions using the Azure portal

Usługa Azure Cosmos DB jest dostępna we wszystkich regionach świadczenia usługi Azure na całym świecie.Azure Cosmos DB is available in all Azure regions worldwide. Po wybraniu domyślnego poziomu spójności dla Twojego konta bazy danych możesz skojarzyć co najmniej jeden region (w zależności od wybranego domyślnego poziomu spójności i globalnych potrzeb dystrybucji).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. W witrynie Azure Portal na pasku po lewej stronie kliknij pozycję Azure Cosmos DB.In the Azure portal, in the left bar, click Azure Cosmos DB.

  2. Na stronie usługi Azure Cosmos DB wybierz konto bazy danych do modyfikacji.In the Azure Cosmos DB page, select the database account to modify.

  3. Na stronie konta kliknij w menu pozycję Replikuj dane globalnie.In the account page, click Replicate data globally from the menu.

  4. Na stronie Globalna replikacja danych wybierz regiony do dodania lub usunięcia, klikając regiony na mapie, a następnie klikając przycisk Zapisz.In the Replicate data globally page, select the regions to add or remove by clicking regions in the map, and then click Save. Dodanie regionu nic nie kosztuje, zobacz cennik lub artykuł Globalna dystrybucja danych za pomocą usługi Azure Cosmos DB, aby uzyskać więcej informacji.There is a cost to adding regions, see the pricing page or the Distribute data globally with Azure Cosmos DB article for more information.

    Kliknij regiony na mapie, aby je dodać lub usunąć

Po dodaniu drugiego regionu w portalu na stronie Globalna replikacja danych zostanie udostępniona opcja Ręczne przejście do trybu failover.Once you add a second region, the Manual Failover option is enabled on the Replicate data globally page in the portal. Ta opcja umożliwia testowanie procesu pracy awaryjnej lub zmianę podstawowego regionu zapisu.You can use this option to test the failover process or change the primary write region. Po dodaniu trzeciego regionu na tej samej stronie zostanie udostępniona opcja Priorytety trybu failover, dzięki czemu możesz zmienić kolejność pracy awaryjnej dla odczytów.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.

Wybieranie regionów globalnej bazy danychSelecting global database regions

Istnieją dwa typowe scenariusze konfigurowania co najmniej dwóch regionów:There are two common scenarios for configuring two or more regions:

  1. Zapewnienie użytkownikom końcowym dostępu z małym opóźnieniem niezależnie od tego, gdzie znajdują się na całym świecieDelivering low-latency access to data to end users no matter where they are located around the globe
  2. Dodawanie regionalnych odporności dla ciągłości prowadzenia działalności biznesowej i odzyskiwania po awarii (BCDR)Adding regional resiliency for business continuity and disaster recovery (BCDR)

Aby zapewnić użytkownikom końcowym małe opóźnienia, zalecane jest wdrożenie zarówno aplikacji, jak i usługi Azure Cosmos DB w regionach, które odpowiadają lokalizacjom użytkowników aplikacji.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.

W przypadku BCDR zalecane jest dodawanie regionów na podstawie par regionów opisanych w artykule Ciągłość działania i odzyskiwanie po awarii (BCDR): sparowane regiony platformy 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.

Nawiązywanie połączenia z preferowanym regionem przy użyciu interfejsu API tabelConnecting to a preferred region using the Table API

Aby można było korzystać z dystrybucji globalnej, w aplikacjach klienckich można określić uporządkowaną listę preferencji regionów, która będzie używana do wykonywania operacji na dokumentach.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. Można to zrobić, ustawiając właściwość TableConnectionPolicy.PreferredLocations.This can be done by setting the TableConnectionPolicy.PreferredLocations property. Na podstawie konfiguracji konta, bieżącej dostępności regionalnej i określonej listy preferencji zestaw SDK interfejsu API tabel usługi Azure Cosmos DB wybiera najbardziej optymalny punkt końcowy do komunikacji.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.

Lista PreferredLocations powinna zawierać rozdzielaną przecinkami listę preferowanych lokalizacji (z obsługą wielu regionów) dla operacji odczytu.The PreferredLocations should contain a comma-separated list of preferred (multi-homing) locations for reads. Każde wystąpienie klienta może określić podzbiór tych regionów w kolejności preferencji w celu zminimalizowania opóźnienia odczytu.Each client instance can specify a subset of these regions in the preferred order for low latency reads. Regiony muszą być nazwane za pomocą ich nazw wyświetlanych, na przykład West US.The regions must be named using their display names, for example, West US.

Wszystkie operacje odczytu są wysyłane do pierwszego dostępnego regionu na liście PreferredLocations.All reads are sent to the first available region in the PreferredLocations list. Jeśli żądanie kończy się niepowodzeniem, klient przechodzi do następnego regionu z listy itd.If the request fails, the client will fail down the list to the next region, and so on.

Zestawy SDK podejmują próby odczytu z regionów określonych na liście PreferredLocations.The SDK attempts to read from the regions specified in PreferredLocations. Na przykład jeśli konto bazy danych jest dostępne w trzech regionach, ale klient określa tylko dwa regiony bez odczytu na liście PreferredLocations, operacje odczytu z regionu zapisu nie są obsługiwane, nawet w przypadku przejścia w tryb 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.

Zestaw SDK automatycznie wysyła wszystkie operacje zapisu do bieżącego regionu zapisu.The SDK automatically sends all writes to the current write region.

Jeśli właściwość PreferredLocations nie została określona, wszystkie żądania są obsługiwane z bieżącego regionu zapisu.If the PreferredLocations property is not set, all requests will be served from the current write region.

To wszystko — na tym kończy się ten samouczek.That's it, that completes this tutorial. Aby dowiedzieć się, jak zarządzać spójnością globalnie replikowanego konta, przeczytaj Poziomy spójności w usłudze Azure Cosmos DB.You can learn how to manage the consistency of your globally replicated account by reading Consistency levels in Azure Cosmos DB. Natomiast aby uzyskać więcej informacji na temat sposobu działania globalnej replikacji w usłudze Azure Cosmos DB, zobacz Dystrybuowanie danych globalnie za pomocą usługi 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.

Następne krokiNext steps

W tym samouczku wykonano następujące czynności:In this tutorial, you've done the following:

  • Konfigurowanie dystrybucji globalnej przy użyciu witryny Azure PortalConfigure global distribution using the Azure portal
  • Konfigurowanie dystrybucji globalnej przy użyciu interfejsu API tabel usługi Azure Cosmos DBConfigure global distribution using the Azure Cosmos DB Table APIs