Udostępnij za pośrednictwem


Biblioteki usługi Azure Cosmos DB dla platformy .NET

Omówienie

Azure Cosmos DB to globalnie rozproszona, wielomodelowa usługa bazy danych. Jest ona przeznaczona do elastycznego i niezależnego skalowania przepływności i magazynu w dowolnej liczbie regionów geograficznych z kompleksową umową SLA. Za pomocą usługi Azure Cosmos DB można przechowywać i uzyskiwać dostęp do dokumentów, klucz-wartość, szerokie kolumny i grafowe bazy danych przy użyciu interfejsów API i modeli programowania.

Rozpoczynanie pracy z usługą Azure Cosmos DB.

Biblioteka kliencka

Użyj biblioteki klienta platformy .NET usługi Azure Cosmos DB, aby uzyskać dostęp do danych i przechowywać je w istniejącym magazynie danych usługi Azure Cosmos DB. Aby zautomatyzować tworzenie nowego konta usługi Azure Cosmos DB, użyj Azure Portal, interfejsu wiersza polecenia lub programu PowerShell.

Zainstaluj pakiet NuGet bezpośrednio z konsoli menedżera pakietów programu Visual Studio lub za pomocą interfejsu wiersza polecenia platformy .NET Core.

Aby zainstalować wersję 3.x, która jest przeznaczona dla platformy .NET Standard:

Menedżer pakietów programu Visual Studio

Install-Package Microsoft.Azure.Cosmos

Interfejs wiersza polecenia platformy .NET Core

dotnet add package Microsoft.Azure.Cosmos

Przykład kodu

Ten przykład łączy się z istniejącą bazą danych interfejsu API SQL usługi Azure Cosmos DB, tworzy nową bazę danych i kontener, odczytuje element z kontenera i deserializuje go do TodoItem obiektu. W tym przykładzie użyto wersji 3.x zestawu .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"));
}

Samples