cloneCollectionAsCapped
정의
cloneCollectionAsCapped
cloneCollectionAsCapped
명령은 동일한 데이터베이스 내의 기존 비 고정 사이즈 컬렉션 에서 새 고정 사이즈 컬렉션 을 생성합니다. 이 작업은 고정 사이즈가 아닌 원본 고정 사이즈 컬렉션 에 영향을 주지 않습니다.
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
중요
이 명령은 M0, M2 및 M5 클러스터 또는 서버리스 인스턴스에서 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
구문
명령은 다음과 같은 구문을 가집니다:
db.runCommand( { cloneCollectionAsCapped: <existing collection>, toCollection: <capped collection>, size: <capped size>, writeConcern: <document>, comment: <any> } )
명령 필드
이 명령은 다음 필드를 사용합니다.
필드 | 설명 |
---|---|
cloneCollectionAsCapped | 복사할 기존 collection의 이름입니다. |
toCollection | 생성할 새 고정 사이즈 컬렉션의 이름입니다. 새 고정 사이즈 컬렉션의 이름은 고유해야 하며 기존 기존 컬렉션의 이름과 같을 수 없습니다. |
size | 고정 사이즈 컬렉션의 최대 크기(바이트)입니다. |
쓰기 고려 | |
comment | 선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.
댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다. |
이 명령은 existing collection
를 복사하고 capped
size
에서 바이트 단위로 지정한 최대 크기로 새 capped collection
를 만듭니다.
원래의 비고정 사이즈 컬렉션을 고정 사이즈 컬렉션으로 바꾸려면 convertToCapped
명령을 사용합니다.
행동
capped size
가 소스 collection의 크기보다 작으면 소스 collection의 모든 문서가 대상 고정 사이즈 컬렉션에 존재하지 않습니다.
이는 작업 기간 동안 데이터베이스 배타 락을 보유합니다. 동일한 데이터베이스에 잠금을 적용한 다른 작업은 해당 작업이 완료될 때까지 차단됩니다. 데이터베이스에 잠금을 적용하는 작업에 관한 내용은 일반적인 클라이언트 작업에서 어떤 잠금을 사용하나요?를 확인하세요.