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

아티클
10/04/2024

적용 대상: 테이블

Azure Cosmos DB for Table의 테이블은 여러 항목에 대한 관리 단위입니다. 항목을 만들거나 관리하려면 먼저 테이블을 만들어야 합니다.

테이블에 이름 지정

Azure Cosmos DB에서 테이블은 관계형 데이터베이스의 테이블과 유사합니다.

참고 항목

API for Table 계정을 사용하면 첫 테이블을 만들 때 기본 데이터베이스가 Azure Cosmos DB 계정 내에 자동으로 생성됩니다.

테이블 만들기

테이블을 만들려면 다음 메서드 중 하나를 호출합니다.

CreateAsync
CreateIfNotExistsAsync

비동기적으로 테이블 만들기

다음 예제에서는 테이블을 비동기적으로 만듭니다.

// New instance of TableClient class referencing the server-side table
TableClient tableClient1 = client.GetTableClient(
    tableName: "adventureworks-1"
);

await tableClient1.CreateAsync();

동일한 이름의 데이터베이스가 이미 있는 경우 TableCient.CreateAsync 메서드는 예외를 throw합니다.

테이블이 아직 없는 경우 비동기적으로 테이블 만들기

다음 예제에서는 계정에 테이블이 아직 없는 경우에만 비동기적으로 테이블을 만듭니다.

// New instance of TableClient class referencing the server-side table
TableClient tableClient2 = client.GetTableClient(
    tableName: "adventureworks-2"
);

await tableClient2.CreateIfNotExistsAsync();

TableClient.CreateIfNotExistsAsync 메서드는 새 테이블이 아직 없는 경우에만 만듭니다. 이 메서드는 동일한 코드를 여러 번 실행하는 경우 오류를 방지하는 데 유용합니다.

다음 단계

이제 테이블을 만들었으므로 다음 가이드를 사용하여 항목을 만듭니다.

항목 만들기

다음을 통해 공유