Udostępnij przez

Konfigurowanie zapisów w wielu regionach w aplikacjach korzystających z usługi Azure Cosmos DB

  • Dotyczy: ✅ NoSQL

W scenariuszach zapisu w wielu regionach można uzyskać korzyść z wydajności, zapisując tylko w regionie zbliżonym do wystąpienia aplikacji. Usługa Azure Cosmos DB obsługuje replikację za kulisami.

Po włączeniu konta dla wielu regionów zapisu należy wprowadzić dwie zmiany w aplikacji w pliku ConnectionPolicy. W elemencie ConnectionPolicy ustaw UseMultipleWriteLocations na true i przekaż nazwę regionu, w którym aplikacja jest wdrażana, do ApplicationRegion. Ta akcja wypełnia właściwość PreferredLocations w oparciu o bliskość geograficzną względem przekazanej lokalizacji. Jeśli nowy region zostanie później dodany do konta, aplikacja nie musi być aktualizowana ani wdrażana ponownie. Automatycznie wykrywa najbliższy region i ustawia się na nim, jeśli wystąpi zdarzenie regionalne.

Uwaga / Notatka

Konta usługi Azure Cosmos DB, które początkowo są skonfigurowane w jednym regionie zapisu, mogą być skonfigurowane w wielu regionach zapisu bez przestojów. Aby dowiedzieć się więcej, zobacz Konfigurowanie wielu regionów zapisu.

Azure Portal

Aby używać zapisów w wielu regionach, włącz konto usługi Azure Cosmos DB dla wielu regionów przy użyciu witryny Azure Portal. Określ regiony, w których aplikacja może zapisywać dane.

  1. Zaloguj się do witryny Azure Portal.

  2. Przejdź do konta usługi Azure Cosmos DB. Z menu otwórz okienko Replikuj dane globalnie .

  3. W opcji Zapisy w wielu regionach wybierz włącz. Automatycznie dodaje istniejące regiony do regionów odczytu i zapisu.

  4. Możesz dodać więcej regionów, wybierając ikony na mapie lub wybierając przycisk Dodaj region . Wszystkie dodane regiony mają włączone operacje odczytu i zapisu.

  5. Po zaktualizowaniu listy regionów wybierz pozycję Zapisz , aby zastosować zmiany.

    Zrzut ekranu przedstawiający sposób włączania zapisów w wielu regionach przy użyciu portalu Azure.

Zestaw .NET SDK w wersji 2

Aby włączyć zapisy w wielu regionach w aplikacji, ustaw UseMultipleWriteLocations na true. Ponadto ustaw na SetCurrentLocation region, w którym aplikacja jest wdrażana i gdzie jest replikowana usługa Azure Cosmos DB:

ConnectionPolicy policy = new ConnectionPolicy
    {
        ConnectionMode = ConnectionMode.Direct,
        ConnectionProtocol = Protocol.Tcp,
        UseMultipleWriteLocations = true
    };
policy.SetCurrentLocation("West US 2");

Zestaw .NET SDK w wersji 3

Aby włączyć zapisy w wielu regionach w aplikacji, ustaw na ApplicationRegion region, w którym aplikacja jest wdrażana i gdzie jest replikowana usługa Azure Cosmos DB:

CosmosClient cosmosClient = new CosmosClient(
    "<connection-string-from-portal>", 
    new CosmosClientOptions()
    {
        ApplicationRegion = Regions.WestUS2,
    });

Opcjonalnie możesz użyć elementu CosmosClientBuilder i WithApplicationRegion , aby uzyskać ten sam wynik:

CosmosClientBuilder cosmosClientBuilder = new CosmosClientBuilder("<connection-string-from-portal>")
            .WithApplicationRegion(Regions.WestUS2);
CosmosClient client = cosmosClientBuilder.Build();

Zestaw SDK języka Java w wersji 4

Aby włączyć zapisy w wielu regionach w aplikacji, wywołaj .multipleWriteRegionsEnabled(true) i .preferredRegions(preferredRegions) w konstruktorze klienta, gdzie preferredRegions to lista regionów, do których dane są replikowane, uporządkowana według preferencji. Najlepiej, aby regiony o najkrótszym dystansie lub najlepszym opóźnieniu zostały wymienione jako pierwsze:

Zestaw JAVA SDK w wersji 4 (Maven com.azure::azure-cosmos) Async API:


ArrayList<String> preferredRegions = new ArrayList<String>();
preferredRegions.add(region);

CosmosAsyncClient client =
        new CosmosClientBuilder()
                .endpoint(HOST)
                .key(MASTER_KEY)
                .multipleWriteRegionsEnabled(true)
                .preferredRegions(preferredRegions)
                .buildAsyncClient();

Async Java V2 SDK

Zestaw SDK języka Java w wersji 2 używa biblioteki Maven com.microsoft.azure::azure-cosmosdb. Aby włączyć zapisy w wielu regionach w aplikacji, ustaw policy.setUsingMultipleWriteLocations(true) i ustaw policy.setPreferredLocations na List regionów, które są replikowane zgodnie z preferencjami. Najlepiej, aby regiony o najkrótszym dystansie lub najlepszym opóźnieniu zostały wymienione jako pierwsze:

ConnectionPolicy policy = new ConnectionPolicy();
policy.setUsingMultipleWriteLocations(true);
policy.setPreferredLocations(Collections.singletonList(region));

AsyncDocumentClient client =
    new AsyncDocumentClient.Builder()
        .withMasterKeyOrResourceToken(this.accountKey)
        .withServiceEndpoint(this.accountEndpoint)
        .withConsistencyLevel(ConsistencyLevel.Eventual)
        .withConnectionPolicy(policy).build();

zestawy SDK Node.js, JavaScript i TypeScript

Aby włączyć zapisy w wielu regionach w aplikacji, ustaw connectionPolicy.UseMultipleWriteLocations na true. Ponadto ustaw na connectionPolicy.PreferredLocations regiony, w których dane są replikowane według preferencji. Najlepiej, aby regiony o najkrótszym dystansie lub najlepszym opóźnieniu zostały wymienione jako pierwsze:

const connectionPolicy: ConnectionPolicy = new ConnectionPolicy();
connectionPolicy.UseMultipleWriteLocations = true;
connectionPolicy.PreferredLocations = [region];

const client = new CosmosClient({
  endpoint: config.endpoint,
  auth: { masterKey: config.key },
  connectionPolicy,
  consistencyLevel: ConsistencyLevel.Eventual
});

Zestaw SDK dla języka Python

Aby włączyć zapisy w wielu regionach w aplikacji, ustaw wartość multiple_write_locationsTrue podczas inicjalizacji klienta i ustaw preferred_locations w kliencie na regiony, w których dane są replikowane, w kolejności preferencji. Najlepiej, aby regiony o najkrótszym dystansie lub najlepszym opóźnieniu zostały wymienione jako pierwsze:

client = cosmos_client.CosmosClient(self.account_endpoint, self.account_key,
                                    multiple_write_locations=True, preferred_locations=[region])

Zestaw SDK dla języka Go

Aby włączyć wiele regionów w aplikacji, użyj polecenia PreferredRegionsClientOptions:

client, err := azcosmos.NewClient(endpoint, token, &azcosmos.ClientOptions{
	PreferredRegions: []string{"West US", "Central US"},
})

Dalsze kroki

  • Last updated on