.NET을 사용하여 Azure Cosmos DB for NoSQL에서 컨테이너 만들기

아티클
08/15/2024

적용 대상: NoSQL

Azure Cosmos DB의 컨테이너는 항목 세트를 저장합니다. 항목을 만들거나 쿼리하거나 관리하려면 먼저 컨테이너를 만들어야 합니다.

컨테이너 이름 지정

Azure Cosmos DB에서 컨테이너는 관계형 데이터베이스의 테이블과 유사합니다. 컨테이너를 만들 때 컨테이너 이름은 컨테이너 리소스 및 모든 자식 항목에 액세스하는 데 사용되는 URI의 세그먼트를 형성합니다.

다음은 컨테이너 이름을 지정할 때의 몇 가지 빠른 규칙입니다.

컨테이너 이름은 비어 있지 않아야 합니다.
컨테이너 이름은 256자보다 길 수 없습니다.

만들어지면 컨테이너의 URI는 다음과 같은 형식입니다.

https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>/colls/<container-name>

팁

컨테이너 이름 제한에 대한 자세한 내용은 서비스 할당량 및 제한을 참조하세요.

컨테이너 만들기

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

CreateContainerAsync
CreateContainerIfNotExistsAsync

비동기적으로 컨테이너 만들기

다음 예는 컨테이너를 비동기적으로 만듭니다.

// New instance of Container class referencing the server-side container
Container container1 = await database.CreateContainerAsync(
    id: "products-1",
    partitionKeyPath: "/category",
    throughput: 400
);

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

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

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

// New instance of Container class referencing the server-side container
Container container2 = await database.CreateContainerIfNotExistsAsync(
    id: "products-2",
    partitionKeyPath: "/category",
    throughput: 400
);

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

응답 구문 분석

지금까지의 모든 예제에서 비동기 요청의 응답은 즉시 Container 형식으로 캐스팅되었습니다. 헤더 및 HTTP 상태 코드를 포함하여 응답에 대한 메타데이터를 구문 분석할 수 있습니다. Database.CreateContainerAsync 및 Database.CreateContainerIfNotExistsAsync 메서드의 실제 반환 형식은 ContainerResponse입니다.

다음 예제에서는 ContainerResponse를 반환하는 Database.CreateContainerIfNotExistsAsync 메서드를 보여 줍니다. 반환되면 응답 속성을 구문 분석한 다음, 결국 기본 Container 개체를 가져올 수 있습니다.

// New instance of Container class referencing the server-side container
ContainerResponse response = await database.CreateContainerIfNotExistsAsync(
    id: "products-3",
    partitionKeyPath: "/category",
    throughput: 400
);
// Parse additional response properties
Container container3 = response.Container;

다음 단계

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

항목 만들기

다음을 통해 공유