sh.moveRange() (mongosh 메서드)

정의

sh.moveRange(namespace, toShard, min, max): 버전 6.0에 추가 되었습니다.
샤드 간에 범위를 이동합니다.
중요
Mongo쉬 방법
이 페이지에서는 mongosh 메서드를 설명합니다. 이는 데이터베이스 명령이나 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다.
데이터베이스 명령에 대해서는 moveRange 명령을 참조하십시오.
MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.

호환성

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

MongoDB Atlas: cloud 에서의 MongoDB 배포를 위한 완전 managed 서비스

참고

이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원 에 대한 자세한 내용은 지원되지 않는 명령을 참조하세요.

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

sh.moveRange(namespace, toShard, min, max)

sh.moveRange() 메서드는 다음 매개 변수를 사용합니다.

Parameter	유형	설명
`namespace`	문자열	이동할 범위 의 데이터베이스 및 컬렉션 설정합니다.
`toShard`	문자열	범위 를 수신할 샤드 의 ID 설정합니다.
`min`	문서	이동할 범위의 최소 키입니다.
`max`	문서	이동할 범위 의 최대 키입니다.

예시

다음 예시 다음이 포함된 컬렉션 사용합니다.

우편 번호를 나타내는 샤드 키 postal.
70007 및 70124 경계가 있는 범위 입니다.

우편 범위 shard02(으)로 이동하려면 다음 메서드를 실행 .

sh.moveRange(
   "contacts.addresses", "shard02",
   { postal: 70007 },
   { postal: 70124 }
)

{
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp({ t: 1742507819, i: 42 }),
    signature: {
      hash: Binary.createFromBase64('AAAAAAAAAAAAAAAAAAAAAAAAAAA=', 0),
      keyId: Long('0')
    }
  },
  operationTime: Timestamp({ t: 1742507819, i: 42 })
}

돌아가기

sh.moveCollection

sh.removeRangeFromZone