convertToCapped (영문)

명령 필드

이 명령은 다음 필드를 사용합니다.

convertToCapped 는 기존 컬렉션(<collection>)을 가져와서 size 인수(<capped size>)로 지정된 최대 크기(바이트)를 가진 고정 사이즈 컬렉션으로 변환합니다.

변환 프로세스 중에 convertToCapped 명령은 다음과 같은 동작을 나타냅니다.

• MongoDB는 원래 컬렉션의 문서를 자연스러운 순서 로 탐색하고 문서를 새 고정 사이즈 컬렉션에 로드합니다.

• 고정 사이즈 컬렉션에 지정된 capped size 가 원본 비고정 사이즈 컬렉션의 크기보다 작은 경우, MongoDB는 삽입 순서 또는 선입 선출 순서에 따라 고정 사이즈 컬렉션의 문서를 덮어씁니다.

• 내부적으로, MongoDB는 collection을 변환하기 위해 다음 절차를 사용합니다.

  • cloneCollectionAsCapped 명령은 고정 사이즈 컬렉션을 생성하고 데이터를 가져옵니다.

  • MongoDB는 원본 collection을 삭제합니다.

  • renameCollection 새로운 고정 사이즈 컬렉션의 이름을 원래 collection의 이름으로 변경합니다.

• 이는 작업 기간 동안 데이터베이스 독점 잠금을 보유합니다. 동일한 데이터베이스에 잠금을 적용한 다른 작업은 해당 작업이 완료될 때까지 차단됩니다. 데이터베이스에 잠금을 적용하는 작업에 관한 내용은 일반적인 클라이언트 작업에서 어떤 잠금을 사용하나요?를 확인하세요.

collection 변환

다음 예제에서는 db.collection.insertOne() 를 사용하여 events collection을 만들고 db.collection.stats() 를 사용하여 collection에 대한 정보를 얻습니다.

db.events.insertOne( { click: 'button-1', time: new Date() } )
db.events.stats()

MongoDB는 다음을 반환합니다:

{
        "ns" : "test.events",
        ...
        "capped" : false,
        ...
}

events collection을 고정 사이즈 컬렉션으로 변환하고 업데이트된 collection 정보를 보려면 다음 명령을 실행합니다.

db.runCommand( { convertToCapped: 'events', size: 8192 } )
db.events.stats()

MongoDB는 다음을 반환합니다:

{
     "ns" : "test.events",
     ...
     "capped" : true,
     "max" : NumberLong("9223372036854775807"),
     "maxSize" : 8192,
     ...
}

convertToCapped 는 _id 필드의 인덱스 외에 새 컬렉션의 원본 컬렉션 인덱스를 다시 만들지 않습니다. 이 컬렉션에 대한 인덱스가 필요한 경우 변환이 완료된 후 이러한 인덱스를 생성해야 합니다.