Azure Cosmos DB-bibliotek för .NET

Artikel
04/03/2023

Översikt

Azure Cosmos DB är en globalt distribuerad databastjänst med flera modeller. Den är utformad för att elastiskt och oberoende skala dataflöde och lagring i valfritt antal geografiska regioner med ett omfattande serviceavtal. Med Azure Cosmos DB kan du lagra och komma åt dokument-, nyckelvärdes-, bredkolumns- och grafdatabaser med hjälp av API:er och programmeringsmodeller.

Kom igång med Azure Cosmos DB.

Klientbibliotek

Använd Azure Cosmos DB .NET-klientbiblioteket för att komma åt och lagra data i ett befintligt Azure Cosmos DB-datalager. Om du vill automatisera skapandet av ett nytt Azure Cosmos DB-konto använder du Azure Portal, CLI eller PowerShell.

Installera NuGet-paketet direkt från Visual Studio Package Manager-konsolen eller med .NET Core CLI.

Så här installerar du version 3.x, som är avsedd för .NET-standard:

Visual Studio Package Manager

Install-Package Microsoft.Azure.Cosmos

.NET Core CLI

dotnet add package Microsoft.Azure.Cosmos

Kodexempel

Det här exemplet ansluter till en befintlig Azure Cosmos DB SQL API-databas, skapar en ny databas och container, läser ett objekt från containern och deserialiserar det till ett TodoItem objekt. I det här exemplet används version 3.x av .NET SDK.

// CosmosClient should always be a singleton for an application
using (CosmosClient cosmosClient = new CosmosClient("endpoint", "primaryKey"))
{
    Container container = cosmosClient.GetContainer("DatabaseId", "ContainerId");
    // Read item from container
    CosmosItemResponse<TodoItem> todoItemResponse = await container.ReadItemAsync<TodoItem>("ItemId", new PartitionKey("partitionKeyValue"));
}

Utforska klient-API:erna

Dela via