문서 메뉴

문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼

정리 고아

이 페이지의 내용

  • 정의
  • 호환성
  • 구문
  • 행동
  • 필요한 액세스 권한
  • 출력

중요

MongoDB 6.0.3부터는 $shardedDataDistribution 단계를 사용하여 애그리게이션을 실행하여 고아 문서가 남아 있지 않은지 확인해야 합니다. 자세한 내용은 고아 문서가 남아 있지 않은지 확인을 참조하세요.

정의

cleanupOrphaned

이 명령을 사용하면 지정된 네임스페이스에 대해 샤드 키의 MinKey 부터 해당 MaxKey 까지의 청크 범위에 있는 고아 문서가 대부분의 샤드 구성원에서 정리될 때까지 기다릴 수 있습니다.

실행하려면 admin 데이터베이스에서 cleanupOrphaned 를 샤드의 프라이머리 복제본 세트 멤버인 mongod 인스턴스에서 직접 실행합니다. cleanupOrphaned 를 실행하기 전에 밸런서를 비활성화할 필요가 없습니다.

참고

인스턴스에서 cleanupOrphaned mongos 를 실행하지 마세요.

호환성

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

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

참고

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

구문

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

db.runCommand(
   {
     cleanupOrphaned: "<database>.<collection>",
     startingFromKey: <minimumShardKeyValue>, // deprecated
     secondaryThrottle: <boolean>, // deprecated
     writeConcern: <document> // deprecated
   }
)

명령 필드

cleanupOrphaned 에는 다음과 같은 필드가 있습니다:

필드
유형
설명
cleanupOrphaned
문자열
분할된 데이터가 정리될 때까지 기다릴 collection의 네임스페이스, 즉 데이터베이스와 collection 이름입니다.

행동

범위 결정

이 필드의 값은 정리 범위의 경계를 결정하는 데 사용되지 않습니다. cleanupOrphaned 명령은 startingFromKey 의 유무에 관계없이 네임스페이스의 모든 범위에 있는 모든 고아 문서가 샤드에서 정리될 때까지 기다렸다가 완료합니다.

필요한 액세스 권한

authorization 로 실행되는 시스템에서cleanupOrphaned 을(를) 실행하려면 clusterAdmin 권한이 있어야 합니다

출력

returnDocument

각 cleanupOrphaned 명령은 다음 필드의 하위 집합이 포함된 문서를 반환합니다.

cleanupOrphaned.ok

성공하면 1 와(과) 같습니다.

1 값은 다음 중 하나를 나타냅니다.

  • 샤드의 cleanupOrphaned 네임스페이스에 고아 문서가 남아 있지 않습니다.

  • cleanupOrphaned 네임스페이스에서 참고된 collection은 샤딩되지 않습니다.

0 값은 오류가 발생했음을 나타냅니다.

← clearJumboFlag
CleanupReshardCollection →

이 페이지의 내용