db.createCollection()

리소스 잠금

db.createCollection() 는 작업 기간 동안 지정된 컬렉션 또는 뷰에 대한 배타 락을 얻습니다. 컬렉션에 대한 모든 후속 작업은 db.createCollection() 에서 잠금을 해제할 때까지 기다려야 합니다. db.createCollection() 는 일반적으로 이 잠금을 짧은 시간 동안 유지합니다.

뷰를 만들려면 데이터베이스의 system.views 컬렉션에 대한 추가 독점 잠금을 얻어야 합니다. 이 잠금은 명령이 완료될 때까지 데이터베이스의 뷰 생성 또는 수정을 차단합니다.

트랜잭션

트랜잭션이 교차 샤드 쓰기 트랜잭션인 이 아닌 경우 분산 트랜잭션 내에서 컬렉션과 인덱스를 생성할 수 있습니다.

트랜잭션에서 db.createCollection()을 사용하려면 트랜잭션에서 읽기 고려 "local"를 사용해야 합니다. "local" 이외의 읽기 고려수준을 지정하면 트랜잭션이 실패합니다.

고정 사이즈 컬렉션 생성

고정 사이즈 컬렉션에는 최대 크기 또는 문서 수가 정해져 있어 최대 임곗값을 초과하여 늘어나는 것을 방지합니다. 모든 고정 사이즈 컬렉션은 최대 크기를 지정해야 하며 최대 문서 수를 지정할 수도 있습니다. MongoDB는 컬렉션이 최대 문서 수에 도달하기 전에 최대 크기 제한에 도달하는 경우 오래된 문서를 제거합니다. 다음 예시를 고려하세요.

db.createCollection("log", { capped : true, size : 5242880, max : 5000 } )

이 명령은 최대 크기가 5메가바이트이고 최대 문서 수가 5000개인 log라는 이름의 컬렉션을 만듭니다.

고정 사이즈 컬렉션에 대한 자세한 내용은 고정 사이즈 컬렉션을 참조하세요.

Time Series 컬렉션 만들기

지난 24시간 동안의 날씨 데이터를 캡처하는 time series 컬렉션을 생성하려면 다음 명령을 실행합니다.

db.createCollection(
    "weather24h",
    {
       timeseries: {
          timeField: "timestamp",
          metaField: "data",
          granularity: "hours"
       },
       expireAfterSeconds: 86400
    }
)

또는 동일한 컬렉션을 생성하되 각 버킷을 동일한 시간 내의 타임스탬프 값으로 제한하려면 다음 명령을 실행합니다.

db.createCollection(
    "weather24h",
    {
       timeseries: {
          timeField: "timestamp",
          metaField: "data",
          bucketMaxSpanSeconds: "3600",
          bucketRoundingSeconds: "3600"
       },
       expireAfterSeconds: 86400
    }
)

클러스터형 컬렉션 생성

다음 db.createCollection() 예시에서는 stocks 이라는 클러스터형 컬렉션 을 추가합니다.

db.createCollection(
   "stocks",
   { clusteredIndex: { "key": { _id: 1 }, "unique": true, "name": "stocks clustered key" } }
)

이 예제에서 clusteredIndex 는 다음을 지정합니다.

• "key": { _id: 1 }, _id 필드에 클러스터형 인덱스 키 값이 설정됩니다.

• "unique": true, 클러스터형 인덱스 키 값이 고유해야 함을 표시합니다.

• "name": "stocks clustered key", 클러스터형 인덱스 이름을 설정합니다.

문서에 대한 변경 스트림 전후 이미지를 사용하여 collection 생성하기

MongoDB 6.0부터는 변경 스트림 이벤트를 사용하여 문서의 변경 전후 버전(문서의 전후 이미지)을 출력할 수 있습니다.

• 사전 이미지는 문서가 교체, 업데이트 또는 삭제되기 전의 문서입니다. 삽입된 문서에는 사전 이미지가 없습니다.

• 사후 이미지는 문서가 삽입, 교체, 업데이트된 후의 문서입니다. 삭제된 문서에 대한 사후 이미지가 없습니다.

• db.createCollection(), create 또는 collMod을(를) 사용하는 컬렉션에 대해 changeStreamPreAndPostImages 을(를) 활성화합니다.

다음 예시에서는 changeStreamPreAndPostImages 가 활성화된 컬렉션을 생성합니다.

db.createCollection(
   "temperatureSensor",
   { changeStreamPreAndPostImages: { enabled: true } }
);

이미지가 다음과 같은 경우 change stream 이벤트에 사전 및 사후 이미지를 사용할 수 없습니다.

• 문서 업데이트 또는 삭제 작업 시 collection에서 활성화되지 않았습니다.

• expireAfterSeconds에서 전후 이미지 보존 시간 설정 이후에 제거됩니다.

  • 다음 예에서는 전체 cluster에서 expireAfterSeconds 을 100 초로 설정합니다.

    use admin
    db.runCommand( {
       setClusterParameter:
          { changeStreamOptions: { preAndPostImages: { expireAfterSeconds: 100 } } }
    } )

  • 다음 예에서는 특정 collection에서 expireAfterSeconds ~ 100 초를 설정합니다.

    use admin
    db.getSiblingDB("my_collection")
      .sensors.watch({ changeStreamOptions:
        { preAndPostImages: { expireAfterSeconds: 100 } } })

  • 다음 예제에서는 expireAfterSeconds 등 현재 changeStreamOptions 설정을 반환합니다.

    db.adminCommand( { getClusterParameter: "changeStreamOptions" } )

  • expireAfterSeconds를 off로 설정하면 기본 보존 정책이 사용되며, 해당 change stream 이벤트가 oplog에서 제거될 때까지 사전 및 사후 이미지가 보존됩니다.

  • change stream 이벤트가 oplog에서 제거되면 expireAfterSeconds 사전 및 사후 이미지 보존 시간에 관계없이 해당 사전 및 사후 이미지도 삭제됩니다.

추가 고려 사항

• 전후 이미지를 활성화하면 저장 공간이 소모되고 처리 시간이 늘어납니다. 필요한 경우에만 전후 이미지를 활성화하세요.

• 변경 스트림 이벤트 크기를 16메가바이트 미만으로 제한합니다. 이벤트 크기를 제한하려면 다음을 수행하면 됩니다.

  • 문서 크기를 8메가바이트로 제한합니다. updateDescription과 같은 다른 change stream 이벤트 필드가 크지 않은 경우 change stream 출력에서 사전 및 사후 이미지를 동시에 요청할 수 있습니다.

  • updateDescription과 같은 다른 change stream 이벤트 필드가 크지 않은 경우 최대 16메가바이트 문서에 대해 change stream 출력에서 사후 이미지만 요청합니다.

  • 다음과 같은 경우 최대 16메가바이트의 문서에 대해 change stream 출력에서 사전 이미지만 요청합니다.

    • 문서 업데이트가 문서 구조나 내용의 작은 부분에만 영향을 미칩니다. 그리고

    • replace 변경 이벤트를 발생시키지 않습니다. replace 이벤트에는 항상 후이미지가 포함됩니다.

• 사전 이미지를 요청하려면 db.collection.watch()에서 fullDocumentBeforeChange를 required 또는 whenAvailable로 설정합니다. 사후 이미지를 요청하려면 동일한 방법으로 fullDocument를 설정합니다.

• 사전 이미지가 config.system.preimages 컬렉션에 기록됩니다.

  • config.system.preimages collection은 커질 수 있습니다. collection 크기를 제한하려면 앞서 표시된 대로 사전 이미지에 대해 expireAfterSeconds 시간을 설정할 수 있습니다.

  • 사전 이미지는 백그라운드 프로세스가 비동기적으로 제거합니다.

데이터 정렬 지정

데이터 정렬을 사용하면 대소문자 및 악센트 표시 규칙과 같은 문자열 비교에 대한 언어별 규칙을 지정할 수 있습니다.

데이터 정렬은 collection 또는 보기 수준에서 지정할 수 있습니다. 예를 들어 다음 연산은 collection에 대한 데이터 정렬을 지정하여 collection을 만듭니다(데이터 정렬 필드에 대한 설명은 데이터 정렬 문서 참조).

db.createCollection( "myColl", { collation: { locale: "fr" } } );

이 데이터 정렬은 다른 데이터 정렬을 명시적으로 지정하지 않는 한 데이터 정렬을 지원하는 인덱스 및 작업에서 사용됩니다. 예를 들어 myColl에 다음 문서를 삽입합니다.

{ _id: 1, category: "café" }
{ _id: 2, category: "cafe" }
{ _id: 3, category: "cafE" }

다음 작업은 컬렉션의 데이터 정렬을 사용합니다.

db.myColl.find().sort( { category: 1 } )

이 작업은 다음 순서로 문서를 반환합니다.

{ "_id" : 2, "category" : "cafe" }
{ "_id" : 3, "category" : "cafE" }
{ "_id" : 1, "category" : "café" }

단순 이진 데이터 정렬을 사용하는 collection에 대한 동일한 작업(즉, 특정 데이터 정렬 세트 없음)은 다음 순서로 문서를 반환합니다.

{ "_id" : 3, "category" : "cafE" }
{ "_id" : 2, "category" : "cafe" }
{ "_id" : 1, "category" : "café" }

스토리지 엔진 옵션 지정하기

db.createCollection()을 사용하여 collection을 생성할 때 collection별 스토리지 엔진 구성 옵션을 지정할 수 있습니다. 다음 작업을 고려하세요.

db.createCollection(
   "users",
   { storageEngine: { wiredTiger: { configString: "<option>=<setting>" } } }
)

이 작업은 MongoDB가 wiredTiger 스토리지 엔진에 전달할 특정 구성 문자열을 사용하여 users라는 새 collection을 생성합니다.

예를 들어, users collection의 파일 블록에 zlib 압축기를 지정하려면 다음 명령을 사용하여 block_compressor 옵션을 설정합니다.

db.createCollection(
   "users",
   { storageEngine: { wiredTiger: { configString: "block_compressor=zlib" } } }
)

MongoDB 7 부터 시작.2 ( 7.0.5), db.createCollection() 를 사용하여 컬렉션을 생성할 때는 wiredTiger 스토리지 엔진 암호화 옵션을 지정할 수 없습니다. WiredTiger 스토리지 엔진에 대한 암호화를 구성하려면 미사용 데이터 암호화를 참조하세요 .