컴팩트
정의
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
중요
이 명령은 M0, M2 및 M5 클러스터에서 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
구문
명령은 다음과 같은 구문을 가집니다:
db.runCommand( { compact: <string>, dryRun: <boolean>, force: <boolean>, // Optional freeSpaceTargetMB: <int>, // Optional comment: <any>, // Optional } )
명령 필드
이 명령은 다음 필드를 사용합니다.
필드 | 유형 | 설명 |
|---|---|---|
compact | 문자열 | 컬렉션의 이름입니다. |
dryRun | 부울 | 버전 8.0에 추가 되었습니다. 활성화하면 Default(기본값): False |
force | 부울 | 버전 4.4에서 변경되었습니다. 선택 사항. |
freeSpaceTargetMB | Integer | 선택 사항. 압축 을 계속 진행하기 위해 복구할 수 있어야 하는 최소 저장 공간(MB)을 지정합니다. 기본값: 20 |
comment | any | 선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.
댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다. |
compact 필수 권한
인증을 시행하는 클러스터의 경우 대상 컬렉션에서 compact 권한 작업을 가진 사용자로 인증해야 합니다. dbAdmin 및 hostManager 역할은 시스템 외 컬렉션에 대해 compact를 실행하는 데 필요한 권한을 제공합니다.
시스템 컬렉션의 경우 다음을 수행해야 합니다.
시스템 컬렉션에 대한
compact조치를 부여하는 사용자 지정 역할을 만듭니다.해당 역할을 신규 또는 기존 사용자에게 부여합니다.
해당 사용자로 인증하여
compact명령을 수행합니다.
예를 들어 다음 작업은 지정된 데이터베이스 및 컬렉션에 대해 compact 작업을 부여하는 사용자 지정 역할을 만듭니다.
use admin db.createRole( { role: "myCustomCompactRole", privileges: [ { resource: { "db" : "<database>" , "collection" : "<collection>" }, actions: [ "compact" ] } ], roles: [] } )
resource 문서 구성에 대한 자세한 내용은 자체 관리형 배포서버의 리소스 문서를 참조하세요.
기존 사용자에게 dbAdmin, hostManager 또는 사용자 지정 역할을 추가하려면 db.grantRolesToUser() 또는 db.updateUser()를 사용합니다. 다음 작업은 admin 데이터베이스의 myCompactUser에 사용자 지정 compact 역할을 부여합니다.
use admin db.grantRolesToUser("myCompactUser", [ "dbAdmin" | "myCustomCompactRole" ] )
새 사용자에게 dbAdmin 또는 사용자 지정 역할을 추가하려면 사용자를 만들 때 db.createUser() 메서드의 roles 배열에 해당 역할을 지정합니다.
use admin db.createUser( { user: "myCompactUser", pwd: "myCompactUserPassword", roles: [ { role: "dbAdmin", db: "<database>" } | "myCustomCompactRole" ] } )
행동
진행 상황 모니터링
compact 작업의 진행률을 확인하려면 mongod 로그 파일을 모니터링하거나 다른 셸 인스턴스에서 db.currentOp() 을(를) 실행합니다.
작업 종료
db.killOp() 메서드를 사용하여 compact를 종료하거나 작업이 완료되기 전에 서버를 다시 시작하면 compact가 종료되고 운영 체제에 디스크 공간을 반환하려는 시도가 실패할 수 있습니다.
디스크 공간
컬렉션의 저장 공간이 어떻게 변경되는지 확인하려면 압축 전후에 collStats 명령을 실행합니다.
WiredTiger에서, compact 은(는) 컬렉션의 데이터 및 인덱스에 필요한 저장 공간을 줄이려고 시도하여 불필요한 디스크 공간을 운영 체제에 해제합니다. 이 작업의 효율성은 작업 부하에 따라 다르며 디스크 공간이 복구될 수 없습니다. 이 명령은 컬렉션에서 많은 양의 데이터를 제거했지만 이를 대체할 계획이 없는 경우에 유용합니다.
compact WiredTiger 데이터베이스에서 실행하려면 추가 디스크 공간이 필요할 수 있습니다.
성능 고려 사항
압축은 정기적으로 데이터베이스를 검사하므로 동기화 오버헤드가 발생할 수 있습니다. 트래픽이 많은 데이터베이스에서는 백업 수행과 같은 운영 작업이 지연되거나 방해받을 수 있습니다. 예기치 않은 중단을 방지하려면 백업을 수행하기 전에 압축을 비활성화하세요.
복제본 세트
복제본 세트에 저장된 컬렉션 및 인덱스에 compact를 사용할 수 있지만 몇 가지 중요한 고려 사항이 있습니다.
프라이머리 노드는
compact명령을 세컨더리 노드에 복제하지 않습니다.가능하면 세컨더리 노드에서
compact를 실행해야 합니다. 세컨더리에서compact를 실행할 수 없는 경우 강제 옵션을 참조하세요.MongoDB 6.1.0 (및 6.0.2 및 5.0.12)에서 시작:
세컨더리 노드는
compact가 실행되는 동안 복제할 수 있습니다.읽기가 허용됩니다.
클러스터에서 compact 을(를) 실행하려면
프라이머리 노드를 다시 할당합니다.
현재 프라이머리를 취소하고 투표를 트리거하려면 rs.stepDown() 메서드를 사용하세요. 특정 세컨더리 노드를 지정하려면 노드 우선 순위를 조정하세요.
세컨더리 노드에 대한 버전별 고려 사항
세컨더리 노드는
compact가 실행되는 동안 복제할 수 있습니다.읽기가 허용됩니다.
compact 명령이 실행되는 동안에는 복제본 세트가 SECONDARY 상태로 유지됩니다.
복제본 세트 노드 상태에 대한 자세한 내용은 복제본 세트 노드 상태를 참조하세요.
복제본 세트의 유지 관리 및 가용성에 관한 자세한 내용은 자체 관리형 복제본 세트 멤버에 대한 유지 관리 수행을 참조하세요.
샤딩된 클러스터
compact mongod 인스턴스에만 적용됩니다. 샤드한 환경에서는 유지 관리 작업으로 각 샤드에서 개별적으로 compact를 실행합니다.
mongos 에 대해서는 compact 를 발행할 수 없습니다.
색인 구축
mongod는 compact 작업 후에 모든 인덱스를 병렬로 다시 작성합니다.
동시 압축 명령은 허용되지 않습니다.
동일한 컬렉션에서 여러 개의 동시 compact 명령을 실행하려고 하면 MongoDB는 오류를 반환합니다.
예시
컬렉션 압축
다음 작업은 movies 컬렉션에서 compact 명령을 실행합니다.
db.runCommand( { compact: "movies" } )
{ bytesFreed: 27859, ok: 1 }
압축 추정
다음 작업은 movies 컬렉션에서 compact 명령의 드라이 런을 수행합니다.
db.runCommand( { compact: "movies", dryRun: true } )
{ estimatedBytesFreed: 27859, ok: 1 }