SDK-regio configureren

  • 7 minuten

De .NET SDK voor Azure Cosmos DB for NoSQL bevat configuratieklassen die kunnen worden gebruikt met de CosmosClient-klasse om te configureren welke regio u wilt dat de SDK zich richt op aanvragen.

Er zijn twee manieren om de SDK-client te configureren:

  • De eigenschap ApplicationRegion gebruiken om één regio voor aanvragen te configureren
  • De eigenschap ApplicationPreferredRegions gebruiken om een lijst met voorkeursregio's te configureren

Een toepassingsregio instellen

De CosmosClientOptions-klasse bevat een set configuratieopties voor nieuwe SDK-clientexemplaren. Met deze klasse kunt u de voorkeursregio configureren voor uw query's en leesbewerkingen. In dit voorbeeld is de eigenschap ApplicationRegion geconfigureerd voor UK - zuid.

CosmosClientOptions options = new () 
{ 
    ApplicationRegion = "UK South"
};
CosmosClient client = new (connectionString, options);

U kunt ook; u kunt de statische klasse Microsoft.Azure.Cosmos.Regions gebruiken die ingebouwde tekenreekseigenschappen voor verschillende Azure-regio's bevat.

CosmosClientOptions options = new () 
{ 
    ApplicationRegion = Regions.UKSouth
};
CosmosClient client = new (connectionString, options);

Als een ander alternatief kunt u de Fluent-klassen CosmosClientBuilder gebruiken om een nieuwe client samen te stellen met de set toepassingsregio's.

CosmosClient client = new CosmosClientBuilder(connectionString)
    .WithApplicationRegion(Regions.UKSouth)
    .Build();

Een lijst met voorkeurstoepassingsregio's instellen

De eigenschap ApplicationPreferredRegions wordt gebruikt om een lijst met geo-gerepliceerde regio's in te stellen die moeten worden gebruikt met de SDK. In dit eerste voorbeeld wordt een tekenreeksverzameling gemaakt met de regiowaarden van Azië - oost, Zuid-Afrika - noord en VS - west. Deze verzameling wordt vervolgens gebruikt om de eigenschap ApplicationPreferredRegions toe te wijzen.

List<string> regions = new()
{
    "East Asia",
    "South Africa North",
    "West US"
};

CosmosClientOptions options = new () 
{ 
    ApplicationPreferredRegions = regions
};
CosmosClient client = new (connectionString, options);

Dit voorbeeld kan ook worden vereenvoudigd met het gebruik van de statische klasse Regio's en de CosmosClientBuilder.

CosmosClient client = new CosmosClientBuilder(connectionString)
    .WithApplicationPreferredRegions(
        new List<string>
        {
            Regions.EastAsia
            Regions.SouthAfricaNorth
            Regions.WestUS
        }
    )
    .Build();