.NET을 사용하여 Azure Cosmos DB for Table 시작

아티클
10/02/2024

적용 대상: 테이블

이 문서에서는 .NET SDK를 사용하여 Azure Cosmos DB for Table에 연결하는 방법을 보여 줍니다. 연결되면 테이블 및 항목에 대한 작업을 수행할 수 있습니다.

필수 조건

활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
Azure Cosmos DB for Table 계정 API for Table 계정을 만듭니다.
.NET 6.0 이상
Azure CLI(명령줄 인터페이스) 또는 Azure PowerShell

프로젝트 설정

console 템플릿에서 dotnet new 명령을 사용하여 새 .NET 애플리케이션을 만듭니다.

dotnet new console

dotnet add package 명령을 사용하여 Azure.Data.Tables NuGet 패키지를 가져옵니다.

dotnet add package Azure.Data.Tables

dotnet build 명령을 사용하여 프로젝트를 빌드합니다.

dotnet build

Azure Cosmos DB for Table에 연결

Azure Cosmos DB의 API for Table에 연결하려면 TableServiceClient 클래스의 인스턴스를 만듭니다. 이 클래스는 테이블에 대한 모든 작업을 수행하기 위한 시작점입니다.

Microsoft Entra를 사용하여 NoSQL용 API 계정에 연결하려면 보안 주체를 사용합니다. 보안 주체의 정확한 유형은 애플리케이션 코드를 호스트하는 위치에 따라 달라집니다. 아래 표는 빠른 참조 가이드 역할을 합니다.

애플리케이션이 실행되는 위치	할당할 수 있습니다.
로컬 컴퓨터(개발 및 테스트)	사용자 ID 또는 서비스 주체
Azure	관리 ID
Azure 외부의 서버 또는 클라이언트	서비스 사용자

Azure.ID 가져오기

Azure.Identity NuGet 패키지에는 모든 Azure SDK 라이브러리 간에 공유되는 핵심 인증 기능이 포함되어 있습니다.

dotnet add package 명령을 사용하여 Azure.Identity NuGet 패키지를 가져옵니다.

dotnet add package Azure.Identity

dotnet build 명령을 사용하여 프로젝트를 다시 빌드합니다.

dotnet build

코드 편집기에서 Azure.Core 및 Azure.Identity 네임스페이스에 대한 using 지시문을 추가합니다.

using Azure.Core;
using Azure.Identity;

기본 자격 증명 구현을 사용하여 CosmosClient 만들기

로컬 컴퓨터에서 테스트하거나 애플리케이션이 관리 ID를 직접 지원하는 Azure 서비스에서 실행되는 경우 DefaultAzureCredential 인스턴스를 만들어 OAuth 토큰을 얻습니다.

다음 예제에서는 SDK에서 다시 사용할 수 있는 더 일반적인 형식인 TokenCredential 형식의 변수에 인스턴스를 저장했습니다.

// Credential class for testing on a local machine or Azure services
TokenCredential credential = new DefaultAzureCredential();

COSMOS_ENDPOINT 환경 변수와 TokenCredential 개체를 매개 변수로 사용하여 CosmosClient 클래스의 새 인스턴스를 만듭니다.

// New instance of TableServiceClient class using Microsoft Entra
TableServiceClient client = new(
    endpoint: Environment.GetEnvironmentVariable("COSMOS_ENDPOINT")!,
    tokenCredential: credential
);

애플리케이션 빌드

애플리케이션을 빌드할 때 코드는 주로 다음 4가지 종류의 리소스와 상호 작용합니다.

API for Table 계정 - Azure Cosmos DB 데이터에 대한 고유한 최상위 네임스페이스입니다.
테이블- 계정의 개별 항목 세트를 포함합니다.
항목 - 테이블의 개별 항목을 나타냅니다.

다음 다이어그램에서는 리소스 간의 관계를 보여줍니다.

계정, 테이블 및 항목을 포함한 Azure Cosmos DB 계층 구조의 다이어그램

각 리소스 종류는 하나 이상의 연결된 .NET 클래스 또는 인터페이스로 표시됩니다. 가장 일반적인 종류의 목록은 다음과 같습니다.

클래스	설명
`TableServiceClient`	이 클라이언트 클래스는 Azure Cosmos DB 서비스에 대한 클라이언트 쪽 논리적 표현을 제공합니다. 이 클라이언트 개체는 서비스에 대한 요청을 구성하고 실행하는 데 사용됩니다.
`TableClient`	이 클라이언트 클래스는 아직 서비스에 있거나 없을 수도 있는 테이블에 대한 참조입니다. 테이블에 액세스하거나 이에 대한 작업을 수행하려고 하면 서버 쪽에서 테이블의 유효성이 검사됩니다.
`ITableEntity`	이 인터페이스는 테이블에 만들어지거나 테이블에서 쿼리되는 모든 항목에 대한 기본 인터페이스입니다. 이 인터페이스는 API for Table의 항목에 대한 모든 필수 속성을 포함합니다.
`TableEntity`	이 클래스는 `ITableEntity` 인터페이스의 제네릭 구현이며 키-값 쌍의 사전입니다.

다음 가이드에서는 이러한 각 클래스를 사용하여 애플리케이션을 빌드하는 방법을 보여 줍니다.

가이드	설명
테이블 만들기	테이블 만들기
항목 만들기	항목 만들기
항목 읽기	항목 읽기

참고 항목

다음 단계

이제 API for Table 계정에 연결했으므로 다음 가이드를 사용하여 테이블을 만들고 관리합니다.

.NET을 사용하여 Azure Cosmos DB for Table에서 테이블 만들기

다음을 통해 공유