Azure Cosmos DB-Bibliotheken für .NET

  • Artikel

Übersicht

Azure Cosmos DB ist ein global verteilter Datenbankdienst mit Unterstützung mehrerer Modelle. Mit diesem Dienst können Sie in einer beliebigen Anzahl von geografischen Azure-Regionen mit einer umfassenden SLA elastische und unabhängige Skalierungen für Durchsatz und Speicher durchführen. Mit Azure Cosmos DB können Sie unter Verwendung von APIs und Programmiermodellen Datenbanken mit Dokumenten, Schlüsselwerten, breiten Spalten und Graphen speichern und auf die Datenbanken zugreifen.

Erste Schritte mit Azure Cosmos DB.

Clientbibliothek

Verwenden Sie die Azure Cosmos DB-.NET-Clientbibliothek, um auf Daten in einem vorhandenen Azure Cosmos DB-Datenspeicher zuzugreifen und Daten dort zu speichern. Die Erstellung eines neuen Azure Cosmos DB-Kontos können Sie mit dem Azure-Portal, mit der CLI oder mit PowerShell automatisieren.

Installieren Sie das NuGet-Paket direkt über die Paket-Manager-Konsole in Visual Studio oder mit der .NET Core CLI.

So installieren Sie Version 3.x, die auf .NET Standard ausgerichtet ist:

Visual Studio-Paket-Manager

Install-Package Microsoft.Azure.Cosmos

.NET Core-CLI

dotnet add package Microsoft.Azure.Cosmos

Codebeispiel

In diesem Beispiel stellen Sie eine Verbindung mit einer vorhandenen Azure Cosmos DB-SQL-API-Datenbank her. Darüber hinaus erstellen Sie eine neue Datenbank und einen neuen Container, lesen ein Element aus dem Container und deserialisieren es in ein TodoItem-Objekt. In diesem Beispiel wird Version 3.x des .NET SDK verwendet.

// 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"));
}

Erkunden der Client-APIs

Beispiele