정의
renameCollection기존 컬렉션의 이름을 변경합니다.
renameCollection에 완전한 네임스페이스(<database>.<collection>) 형태로 컬렉션 이름을 지정합니다.팁
mongosh에서 이 명령은renameCollection()헬퍼 메서드를 통해서도 실행 수 있습니다.헬퍼 메서드는 사용자에게 편리하지만 데이터베이스 명령과 동일한 수준의 정보를 반환하지 않을 수 있습니다. 편의가 필요하지 않거나 추가 반환 필드가 필요한 경우 데이터베이스 명령
mongosh사용합니다.관리 데이터베이스에 대해
renameCollection명령을 실행합니다.
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
- MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
참고
이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원에 관해 자세히 알아보려면 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
Stable API 지원
MongoDB 8.1부터 renameCollection 이(가) Stable API V1에 포함됩니다. Stable API 에서 renameCollection 를 사용하려면 MongoDB 8.1 이상을 실행 하는 배포서버 에 운전자 연결해야 합니다.
구문
명령은 다음과 같은 구문을 가집니다:
db.runCommand( { renameCollection: "<source_namespace>", to: "<target_namespace>", dropTarget: <true|false>, writeConcern: <document>, comment: <any> } )
명령 필드
이 명령에는 다음 필드가 포함됩니다.
필드 | 유형 | 설명 |
|---|---|---|
| 문자열 | 이름을 바꿀 컬렉션의 네임스페이스입니다. 네임스페이스는 데이터베이스 이름과 컬렉션 이름의 조합입니다. |
| 문자열 | 컬렉션의 새 네임스페이스입니다. 새 네임스페이스가 다른 데이터베이스를 지정하는 경우 MongoDB Atlas 배포서버에서는 |
| 부울 | 선택 사항입니다. |
| 문서 | 선택 사항입니다. 작업에 대한 쓰기 고려를 표현하는 문서입니다. 기본값 쓰기 고려를 사용하려면 생략합니다. 샤딩된 클러스터 에서 실행하는 경우 |
| any | 선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.
댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다. |
행동
샤드 컬렉션
renameCollection 명령을 사용하여 샤딩된 컬렉션 의 이름을 변경할 수 있습니다. 대상 데이터베이스 소스 데이터베이스 와 동일해야 합니다. 이 작업은 모든 인덱스를 보존합니다.
샤딩되지 않은 컬렉션
소스 데이터베이스와 대상 데이터베이스에 동일한 프라이머리 샤드 있는 한 renameCollection 를 사용하여 샤딩된 클러스터 에서 샤딩되지 않은 컬렉션 이름을 바꿀 수 있습니다. renameCollection 를 실행 동일한 데이터베이스 에서 컬렉션 이름을 바꾸는 경우 작업은 컬렉션 데이터와 인덱스를 보존합니다. 다른 데이터베이스 대해 renameCollection 를 실행 경우 작업은 컬렉션 데이터와 인덱스를 새 파일에 다시 씁니다.
Time Series 컬렉션
Time Series 컬렉션의 이름을 변경하는 데는 renameCollection을 사용할 수 없습니다. 자세한 내용은 Time Series 컬렉션 제한 을 참조하세요.
기존 대상 컬렉션
renameCollection target이 기존 컬렉션의 이름이고, 그리고 dropTarget: true를 지정하지 않으면 실패합니다.
진행 중인 인덱스 빌드
소스 컬렉션 에서 인덱스 빌드 진행 중인 경우 이름 바꾸기 작업이 실패하고 BackgroundOperationInProgressForNamespace 오류가 발생합니다. 대상 컬렉션 에서 인덱스 빌드 진행 중이고 dropTarget: true을 지정하는 경우에도 작업이 실패합니다.
컬렉션 의 이름을 바꾸려면 인덱스 빌드 완료될 때까지 기다린 다음 작업을 다시 시도합니다. 진행 중인 인덱스 빌드를 확인하려면 메서드를 db.currentOp() 사용합니다.
성능
renameCollection 대상 네임스페이스에 따라 성능에 미치는 영향이 다릅니다.
대상 데이터베이스가 소스 데이터베이스와 동일한 경우 renameCollection은 네임스페이스만 변경합니다. 이는 빠른 작업입니다.
대상 데이터베이스가 소스 데이터베이스와 다른 경우 renameCollection은 소스 컬렉션의 모든 문서를 대상 컬렉션으로 복사합니다. 컬렉션의 크기에 따라 완료하는 데 시간이 더 걸릴 수 있습니다.
샤딩된 클러스터의 리소스 잠금
버전 5.0에서 변경되었습니다.
샤딩된 클러스터에서 샤딩된 컬렉션이나 샤딩되지 않은 컬렉션의 이름을 변경할 때 소스 및 대상 컬렉션은 모든 샤드에서만 독점적으로 잠깁니다. 소스 및 대상 컬렉션에 대한 후속 작업은 이름 바꾸기 작업이 완료될 때까지 기다려야 합니다.
MongoDB 잠금에 대한 자세한 내용은 FAQ: 동시성을 참조하세요.
복제본 세트의 리소스 잠금
동일한 데이터베이스 내에서 컬렉션의 이름을 변경하는 경우 renameCollection은 작업 기간 동안 소스 및 대상 컬렉션에 대한 배타적 잠금을 얻습니다. 컬렉션에 대한 모든 후속 작업은 renameCollection이 완료될 때까지 대기해야 합니다.
다른 데이터베이스 간에 컬렉션의 이름을 변경하는 경우 renameCollection은 대상 데이터베이스에 대해 배타적(W) 잠금을, 소스 데이터베이스에 대해 의도적 공유(r) 잠금을, 소스 컬렉션에 대해 공유(S) 잠금을 얻습니다. 대상 데이터베이스에 대한 후속 작업은 renameCollection이 독점 데이터베이스 잠금을 해제할 때까지 대기해야 합니다.
MongoDB 잠금에 대한 자세한 내용은 FAQ: 동시성을 참조하세요.
local Database
복제된 데이터베이스의 컬렉션 이름을 복제되지 않은
local데이터베이스로 바꿀 수 없습니다.복제되지 않은
local데이터베이스의 collection 이름은 복제된 데이터베이스로 변경할 수 없습니다.
커서 열기 및 Change Streams
경고
db.collection.renameCollection() 메서드 및 renameCollection 명령은 열린 커서를 무효화합니다. 이렇게 하면 소스 또는 대상 컬렉션 에서 열린 기존 변경 스트림에 대해 무효화 이벤트 생성되고, 이름이 변경된 컬렉션 에서 현재 데이터를 반환하고 있는 쿼리도 중단됩니다.
다음과의 상호 작용 mongodump
클라이언트 덤프 프로세스 중에 명령을 실행하면 로 mongodump 시작된 는 실패합니다. 자세한 내용은 --oplog 를 renameCollection mongodump.--oplog 참조하세요.
예시
다음 예시에서는 test 데이터베이스의 orders collection 이름을 test 데이터베이스의 orders2014로 변경합니다.
db.adminCommand( { renameCollection: "test.orders", to: "test.orders2014" } )
mongosh는 동일한 db.collection.renameCollection() 데이터베이스 내에서 컬렉션의 이름을 바꾸는 명령에 대한 헬퍼를 제공합니다. 다음은 이전 예시 와 동일합니다.
use test db.orders.renameCollection( "orders2014" )