Поделиться через

Библиотеки Azure Cosmos DB для .NET

  • Статья

Общие сведения

Azure Cosmos DB — это многомодельная глобально распределенная служба баз данных. Она позволяет эластично и независимо масштабировать пропускную способность и ресурсы хранилища в любом количестве географических регионов в рамках всестороннего соглашения об уровне обслуживания. Благодаря Azure Cosmos DB можно хранить и использовать базы данных документов, пар "ключ — значение", базы данных с широкими столбцами и базы данных графов при помощи API-интерфейсов и моделей программирования.

Начало работы с Azure Cosmos DB.

Клиентская библиотека

Клиентская библиотека Azure Cosmos DB для .NET используется для доступа к данным и их хранения в существующем хранилище данных Azure Cosmos DB. Автоматически создать учетную запись Azure Cosmos DB можно с помощью портала Azure, интерфейса командной строки или PowerShell.

Установите пакет NuGet непосредственно из консоли диспетчера пакетов Visual Studio или с помощью .NET Core CLI.

Чтобы установить версию 3.x, предназначенную для .NET Standard, выполните приведенные ниже действия.

Диспетчер пакетов Visual Studio

Install-Package Microsoft.Azure.Cosmos

.NET Core CLI

dotnet add package Microsoft.Azure.Cosmos

Пример кода

В этом примере устанавливается подключение к существующей базе данных API SQL в Azure Cosmos DB, создается база данных и контейнер, считывается элемент из контейнера, который затем десериализируется как объект TodoItem. В этом примере используется версия 3.x пакета SDK для .NET.

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

Изучение клиентских API

Примеры