Einrichten der globalen Verteilung von Azure Cosmos DB mithilfe der Tabellen-APISet up Azure Cosmos DB global distribution using the Table API

In diesem Artikel werden die folgenden Aufgaben behandelt:This article covers the following tasks:

  • Konfigurieren der globalen Verteilung mit dem Azure-PortalConfigure global distribution using the Azure portal
  • Konfigurieren der globalen Verteilung mit der Tabellen-APIConfigure global distribution using the Table API

Hinzufügen globaler Datenbankregionen über das Azure-PortalAdd global database regions using the Azure portal

Azure Cosmos DB ist in allen Azure-Regionen weltweit verfügbar.Azure Cosmos DB is available in all Azure regions worldwide. Nachdem Sie die Standardkonsistenzebene für Ihr Datenbankkonto ausgewählt haben, können Sie dem Konto eine oder mehrere Regionen zuordnen (je nachdem, welche Konsistenzebene Sie ausgewählt haben und welche Anforderungen an eine globale Verteilung bestehen).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. Klicken Sie im Azure-Portal auf der linken Leiste auf Azure Cosmos DB.In the Azure portal, in the left bar, click Azure Cosmos DB.

  2. Wählen Sie auf der Seite Azure Cosmos DB das zu ändernde Datenbankkonto aus.In the Azure Cosmos DB page, select the database account to modify.

  3. Klicken Sie auf der Kontoseite im Menü auf Daten global replizieren.In the account page, click Replicate data globally from the menu.

  4. Wählen Sie auf der Seite Daten global replizieren die Regionen aus, die Sie hinzufügen oder entfernen möchten. Klicken Sie hierzu auf die Regionen auf der Karte, und klicken Sie anschließend auf Speichern.In the Replicate data globally page, select the regions to add or remove by clicking regions in the map, and then click Save. Für das Hinzufügen von Regionen entstehen Kosten. Weitere Informationen hierzu finden Sie auf der Seite mit Preisinformationen sowie im Artikel Globale Verteilung von Daten mit 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.

    Hinzufügen oder Entfernen von Regionen per Klick auf die Regionen auf der Karte

Nachdem Sie eine zweite Region hinzugefügt haben, wird im Portal auf der Seite Daten global replizieren die Option Manuelles Failover aktiviert.Once you add a second region, the Manual Failover option is enabled on the Replicate data globally page in the portal. Sie können diese Option verwenden, um den Failovervorgang, zu testen oder die primäre Schreibregion zu ändern.You can use this option to test the failover process or change the primary write region. Nachdem Sie eine dritte Region hinzugefügt haben, wird auf der gleichen Seite die Option Failoverprioritäten aktiviert, sodass Sie die Failoverreihenfolge für Lesevorgänge ändern können.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.

Auswählen von globalen DatenbankregionenSelecting global database regions

Es gibt zwei gängige Szenarios zum Konfigurieren von mindestens zwei oder mehr Regionen:There are two common scenarios for configuring two or more regions:

  1. Übermitteln von niedriger Latenz beim Zugriff auf Daten für Endbenutzer, unabhängig davon, wo sie sich befindenDelivering low-latency access to data to end users no matter where they are located around the globe
  2. Hinzufügen von regionaler Resilienz für Geschäftskontinuität und Notfallwiederherstellung (BCDR)Adding regional resiliency for business continuity and disaster recovery (BCDR)

Zur Gewährleistung geringer Wartezeiten für Endbenutzer empfiehlt es sich, sowohl die Anwendung als auch Azure Cosmos DB in den Regionen bereitzustellen, in denen sich die Benutzer der Anwendung befinden.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.

Für BCDR empfiehlt es sich, die Regionen basierend auf den Regionspaaren hinzuzufügen, die im Artikel Geschäftskontinuität und Notfallwiederherstellung: Azure-Regionspaare beschrieben werden.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.

Herstellen einer Verbindung mit einer bevorzugten Region mithilfe der Tabellen-APIConnecting to a preferred region using the Table API

Um die globale Verteilung nutzen zu können, sollte von Clientanwendungen der aktuelle Standort angegeben werden, an dem die Anwendung ausgeführt wird.In order to take advantage of the global distribution, client applications should specify the current location where their application is running. Hierfür wird die CosmosExecutorConfiguration.CurrentRegion-Eigenschaft festgelegt.This is done by setting the CosmosExecutorConfiguration.CurrentRegion property. Die CurrentRegion-Eigenschaft sollte nur einen Standort enthalten.The CurrentRegion property should contain a single location. Jede Clientinstanz kann ihre eigene Region angeben, um für Lesevorgänge eine geringe Latenz zu erzielen.Each client instance can specify their own region for low latency reads. Für die Benennung der Region muss jeweils der Anzeigename, z. B. „USA, Westen“ verwendet werden.The region must be named by using their display names such as "West US".

Das Azure Cosmos DB Table API SDK wählt je nach Kontokonfiguration und aktueller regionaler Verfügbarkeit automatisch den optimalen Endpunkt für die Kommunikation aus.The Azure Cosmos DB Table API SDK automatically picks the best endpoint to communicate with based on the account configuration and current regional availability. Die nächstgelegene Region erhält Vorrang, um für Clients die Latenz zu verringern.It prioritizes the closest region to provide better latency to clients. Nachdem Sie die aktuelle CurrentRegion-Eigenschaft festgelegt haben, werden Lese- und Schreibanforderungen wie folgt weitergeleitet:After you set the current CurrentRegion property, read and write requests are directed as follows:

  • Leseanforderungen: Alle Leseanforderungen werden an die konfigurierte aktuelle Region (CurrentRegion) gesendet.Read requests: All read requests are sent to the configured CurrentRegion. Basierend auf der jeweiligen Nähe wählt das SDK automatisch eine Fallbackregion mit Georeplikation aus, um für Hochverfügbarkeit zu sorgen.Based on the proximity, the SDK automatically selects a fallback geo-replicated region for high availability.

  • Schreibanforderungen: Das SDK sendet alle Schreibanforderungen automatisch an die aktuelle Schreibregion.Write requests: The SDK automatically sends all write requests to the current write region. Unter einem Multimaster-Konto werden die Schreibanforderungen auch von der aktuellen Region bereitgestellt.In a multi master account, current region will serve the writes requests as well. Basierend auf der jeweiligen Nähe wählt das SDK automatisch eine Fallbackregion mit Georeplikation aus, um für Hochverfügbarkeit zu sorgen.Based on the proximity, the SDK automatically selects a fallback geo-replicated region for high availability.

Wenn Sie die CurrentRegion-Eigenschaft auch angeben, nutzt das SDK die aktuelle Schreibregion für alle Vorgänge.If you don't specify the CurrentRegion property, the SDK uses the current write region for all operations.

Beispiel: Ein Azure Cosmos-Konto befindet sich in den Regionen „USA, Westen“ und „USA, Osten“.For example, if an Azure Cosmos account is in "West US" and "East US" regions. Angenommen, „USA, Westen“ ist die Schreibregion, und die Anwendung befindet sich in „USA, Osten“.If "West US" is the write region and the application is present in "East US". Wenn die „CurrentRegion“-Eigenschaft nicht konfiguriert ist, werden alle Lese- und Schreibanforderungen immer an die Region „USA, Westen“ geleitet.If the CurrentRegion property is not configured, all the read and write requests are always directed to the "West US" region. Wenn die „CurrentRegion“-Eigenschaft konfiguriert ist, werden alle Leseanforderungen über die Region „USA, Osten“ bereitgestellt.If the CurrentRegion property is configured, all the read requests are served from "East US" region.

Nächste SchritteNext steps

In diesem Tutorial haben Sie die folgenden Aufgaben ausgeführt:In this tutorial, you've done the following:

  • Konfigurieren der globalen Verteilung mit dem Azure-PortalConfigure global distribution using the Azure portal
  • Konfigurieren der globalen Verteilung mithilfe der Table-APIs von Azure Cosmos DBConfigure global distribution using the Azure Cosmos DB Table APIs