Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
참조
/
데이터베이스 명령
/
관리

컴팩트

이 페이지의 내용

  • 정의
  • 호환성
  • 구문
  • 명령 필드
  • compact 필수 권한
  • 행동

정의

compact

컬렉션 의 모든 데이터와 인덱스를 다시 쓰고 조각 모음합니다. WiredTiger 데이터베이스에서 이 명령은 불필요한 디스크 공간을 운영 체제에 출시하다 합니다.

호환성

이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

  • MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

중요

이 명령은 M0, M2 및 M5 클러스터에서 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.

구문

명령은 다음과 같은 구문을 가집니다:

{ compact: <collection name> }

명령 필드

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

참고

MongoDB 4.2부터

MongoDB 는compact에 대한 MMAPv1 storage engine 과 MMAPv1 특정 옵션 paddingFactor, paddingBytes, preservePadding 를 제거 합니다.

필드
유형
설명

compact

문자열

컬렉션의 이름입니다.

force

flag

선택 사항. 지정된 경우 v4.4 부터 시작하여 compact 복제본 세트 의 프라이머리 에서 를 강제로 실행 합니다. v.4 4 이전에는 compact 이 부울 필드 값이 인 경우 복제본 세트 의 프라이머리 에서 true 를 실행 수 있도록 허용하고, 값이 인 경우 프라이머리 에서 false 실행 시 오류를 반환했습니다. 명령이 다른 모든 작업을 차단했기 때문입니다.

v4.4부터 compact 는 압축 중인 데이터베이스 에서 MongoDB CRUD 작업을 차단 하지 않습니다.

comment

any

선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.

댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다.

버전 4.4에 추가되었습니다.

compact 필수 권한

인증 을 시행하는 클러스터의 경우 대상 컬렉션에 대해 compact 권한 작업을 가진 사용자로 인증해야 합니다. dbAdmin 역할은 비시스템 컬렉션에 대해 compact 를 실행하는 데 필요한 권한을 제공합니다.

resource 문서 구성에 대한 자세한 내용은 자체 관리형 배포서버의 리소스 문서를 참조하세요.

기존 사용자에게 dbAdmin 또는 사용자 지정 역할을 추가하려면 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"
     ]
   }
)

행동

차단

차단 동작은 버전에 따라 다릅니다.

버전

행동 차단

4.4

포스트 4.4.17 및 5.0.12

복제본 세트에서 compact을 실행하려면 추가 고려 사항은 복제본 세트를 참조하세요.

진행 상황 모니터링

compact 작업의 진행률을 확인하려면 mongod 로그 파일을 모니터링하거나 다른 셸 인스턴스에서 db.currentOp() 을(를) 실행합니다.

작업 종료

db.killOp() 메서드를 사용하여 compact를 종료하거나 작업이 완료되기 전에 서버를 다시 시작하면 compact가 종료되고 운영 체제에 디스크 공간을 반환하려는 시도가 실패할 수 있습니다.

디스크 공간

컬렉션의 저장 공간이 어떻게 변경되는지 확인하려면 압축 전후에 collStats 명령을 실행합니다.

WiredTiger 에서 compact 는 컬렉션의 데이터 및 인덱스에 필요한 저장 공간을 줄이려고 시도하여 불필요한 디스크 공간을 운영 체제에 해제합니다. 이 작업의 효율성은 워크로드에 따라 다르며 디스크 공간이 복구될 수 없습니다. 이 명령은 컬렉션에서 많은 양의 데이터를 제거했지만 이를 대체할 계획이 없는 경우에 유용합니다.

compact WiredTiger 데이터베이스에서 실행하려면 추가 디스크 공간이 필요할 수 있습니다.

복제본 세트

복제본 세트에 저장된 컬렉션 및 인덱스에 compact를 사용할 수 있지만 몇 가지 중요한 고려 사항이 있습니다.

  • 프라이머리 노드는 compact 명령을 세컨더리 노드에 복제하지 않습니다.

  • 가능하면 세컨더리 노드에서 compact를 실행해야 합니다. 세컨더리에서 compact를 실행할 수 없는 경우 강제 옵션을 참조하세요.

  • MongoDB 5.0.12부터는

    • 세컨더리 노드는 compact가 실행되는 동안 복제할 수 있습니다.

    • 읽기가 허용됩니다.

클러스터에서 compact 을(를) 실행하려면

1

보조 노드를 압축합니다.

세컨더리 노드 중 하나에서 compact를 실행합니다. compact가 완료되면 나머지 세컨더리 각각에 대해 작업을 차례로 반복합니다.

2

프라이머리 노드를 다시 할당합니다.

현재 프라이머리를 취소하고 투표를 트리거하려면 rs.stepDown() 메서드를 사용하세요. 특정 세컨더리 노드를 지정하려면 노드 우선 순위를 조정하세요.

3

기존 프라이머리를 압축합니다.

단계를 낮추면 이전 프라이머리 노드가 보조 노드가 됩니다. 이전 프라이머리 노드에서 compact 을(를) 실행합니다.

세컨더리 노드에 대한 버전별 고려 사항

보조 노드의 차단 동작은 버전에 따라 다릅니다.

버전

행동 차단

4.4

  • 복제는 불가능합니다.

  • 읽기는 허용되지 않습니다.

포스트 4.4.17 및 5.0.12

  • 세컨더리 노드는 compact가 실행되는 동안 복제할 수 있습니다.

  • 읽기가 허용됩니다.

compact 명령이 실행되는 동안에는 복제본 세트가 SECONDARY 상태로 유지됩니다.

복제본 세트 노드 상태에 대한 자세한 내용은 복제본 세트 노드 상태를 참조하세요.

복제본 세트의 유지 관리 및 가용성에 관한 자세한 내용은 자체 관리형 복제본 세트 멤버에 대한 유지 관리 수행을 참조하세요.

샤딩된 클러스터

compact 은 mongod 인스턴스에만 적용됩니다. 샤드 환경에서는 유지 관리 작업으로 각 샤드에서 개별적으로 compact 를 실행합니다.

인스턴스에 compact mongos 대해 를 실행할 수 없습니다.

색인 구축

mongod 는 compact 작업에 이어 모든 인덱스를 병렬로 다시 작성합니다.

돌아가기

콜모드

다음

convertToCapped (영문)