.NET용 Azure Cosmos DB 라이브러리

개요

Azure Cosmos DB는 전 세계에 배포된 다중 모델 데이터베이스 서비스입니다. 해당 서비스는 포괄적인 SLA를 제공하는 원하는 수의 지역에서 처리량 및 스토리지 크기를 탄력적 및 독립적으로 조정할 수 있도록 설계되었습니다. Azure Cosmos DB를 사용하면 API 및 프로그래밍 모델을 사용하여 문서, 키-값, 넓은 열 및 그래프 데이터베이스를 저장하고 액세스할 수 있습니다.

Azure Cosmos DB를 시작합니다.

클라이언트 라이브러리

Azure Cosmos DB .NET 클라이언트 라이브러리를 사용하여 기존 Azure Cosmos DB 데이터 저장소에 액세스하고 데이터를 저장합니다. 새 Azure Cosmos DB 계정 만들기를 자동화하려면 Azure Portal, CLI 또는 PowerShell을 사용합니다.

Visual Studio 패키지 관리자 콘솔 또는 .NET Core CLI를 사용하여 NuGet 패키지를 직접 설치합니다.

.NET 표준을 대상으로 하는 버전 3.x를 설치하려면 다음을 수행합니다.

Visual Studio 패키지 관리자

Install-Package Microsoft.Azure.Cosmos

.NET Core CLI

dotnet add package Microsoft.Azure.Cosmos

코드 예

이 예제는 기존 Azure Cosmos DB SQL API 데이터베이스에 연결하고, 새 데이터베이스와 컨테이너를 만들고, 컨테이너에서 항목을 읽고, TodoItem 개체로 역직렬화합니다. 이 예제에서는 .NET SDK의 3.x 버전을 사용합니다.

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

샘플