다음을 통해 공유

Azure Cosmos DB for MongoDB에서 컬렉션 만들기

  • 아티클

적용 대상: MongoDB

이 문서에서는 Azure Cosmos DB for MongoDB에서 컬렉션을 만드는 다양한 방법을 설명합니다. Azure Portal, Azure CLI, PowerShell 또는 지원되는 SDK를 사용하여 컬렉션을 만드는 방법을 보여 줍니다. 이 문서에서는 컬렉션을 만들고 파티션 키를 지정하고 처리량을 프로비저닝하는 방법을 보여 줍니다.

참고 항목

컨테이너 및 컬렉션은 관계형 데이터베이스의 테이블과 유사합니다. Azure Cosmos DB for NoSQL 및 Azure Portal 전체에서 컨테이너를 참조하되, Azure Cosmos DB for MongoDB 컨텍스트에서 컬렉션을 사용하여 MongoDB에서 사용되는 용어와 일치시킵니다.

이 문서에서는 Azure Cosmos DB for MongoDB에서 컬렉션을 만드는 다양한 방법을 설명합니다. 다른 API를 사용하는 경우 API for NoSQL, API for Cassandra, API for Gremlin 및 API for Table 문서를 참조하여 컬렉션을 만듭니다.

참고 항목

컬렉션을 만들 때 이름은 같지만 대/소문자가 다른 컬렉션을 두 개 만들지 않도록 합니다. Azure 플랫폼의 일부 부분에서는 대/소문자를 구분하지 않으므로 이로 인해 이러한 이름을 가진 컬렉션에 대한 원격 분석 및 작업의 혼동/충돌이 발생할 수 있습니다.

Azure Portal을 사용하여 만들기

  1. Azure Portal에 로그인합니다.

  2. 새 Azure Cosmos DB 계정을 만들거나 기존 계정을 선택합니다.

  3. 데이터 탐색기 창을 열어 새 컨테이너를 선택합니다. 다음으로, 다음과 같은 세부 정보를 제공합니다.

    • 새 데이터베이스를 만드는지 아니면 기존 데이터베이스를 사용하는지 표시합니다.
    • 컨테이너 ID를 입력합니다.
    • 분할 키를 입력합니다.
    • 프로비저닝할 처리량을 입력합니다(예: 1000RU).
    • 확인을 선택합니다.

    Azure Cosmos DB for MongoDB, 컨테이너 추가 대화 상자의 스크린샷

NET SDK를 사용하여 만들기

var bson = new BsonDocument
{
    { "customAction", "CreateCollection" },
    { "collection", "<CollectionName>" },//update CollectionName
    { "shardKey", "<ShardKeyName>" }, //update ShardKey
    { "offerThroughput", 400} //update Throughput
};
var shellCommand = new BsonDocumentCommand<BsonDocument>(bson);
// Create a collection with a partition key by using Mongo Driver:
db.RunCommand(shellCommand);

컬렉션을 만들 때 시간 제한 예외가 발생하면 읽기 작업을 수행하여 컬렉션이 성공적으로 만들어졌는지 확인합니다. 읽기 작업은 컬렉션 만들기 작업이 성공할 때까지 예외를 발생시킵니다. 만들기 작업에서 지원되는 상태 코드 목록은 Azure Cosmos DB에 대한 HTTP 상태 코드 문서를 참조하세요.

Azure CLI를 사용하여 만들기

Azure CLI를 사용하여 Azure Cosmos DB for API for MongoDB용 컬렉션을 만듭니다. 모든 Azure Cosmos DB API에 대한 모든 Azure CLI 샘플 목록은 Azure Cosmos DB에 대한 Azure CLI 샘플을 참조하세요.

PowerShell을 사용하여 만들기

PowerShell을 사용하여 Azure Cosmos DB for API for MongoDB용 컬렉션을 만듭니다. 모든 Azure Cosmos DB API에 대한 모든 PowerShell 샘플 목록은 PowerShell Samples를 참조하세요.

Azure Resource Manager 템플릿을 사용하여 컬렉션 만들기

Resource Manager 템플릿을 사용하여 Azure Cosmos DB for API for MongoDB용 컬렉션을 만듭니다.

다음 단계