Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
참조
/
Mongo쉬 방법
/
샤딩

sh.moveChunk()

이 페이지의 내용

  • 정의
  • 호환성
  • 예제

정의

sh.moveChunk(namespace, query, destination)

query 에 의해 지정된 문서가 포함된 청크 를 destination 샤드로 이동합니다. sh.moveChunk() 는 moveChunk 데이터베이스 명령에 대한 래퍼를 제공합니다.

중요

대부분의 경우 밸런서 가 청크 를 자동으로 마이그레이션하도록 허용하고 sh.moveChunk() 을 직접 호출하지 않습니다.

경고

이 명령은 moveChunk 명령의 find 옵션을 사용하므로 해시 샤드 키에는 사용할 수 없습니다. 해시된 샤드 키 를 사용하여 청크를 이동하려면 필드를 지정하는 moveChunk 명령을 bounds 사용합니다.

중요

Mongo쉬 방법

이 페이지에서는 mongosh 메서드에 대해 설명합니다. 이는 데이터베이스 명령 또는 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다.

데이터베이스 명령에 대해서는 moveChunk 명령을 참조하십시오.

MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.

sh.moveChunk() 다음 인수를 사용합니다.

Parameter
유형
설명
namespace
문자열
마이그레이션할 청크가 포함된 샤드 collection의 네임스페이스 입니다.
query
문서
이동할 청크를 선택하는 샤드 키의 동등성 매치입니다.
destination
문자열
이동할 샤드의 이름입니다.

청크의 문서 수가 구성된 청크 크기 를 평균 문서 크기로 나눈 결과의 2 배보다 크면 기본적으로 MongoDB는 청크를 이동할 수 없습니다. moveChunk 명령은 forceJumbo 옵션을 지정하여 점보 레이블 유무에 관계없이 너무 커서 이동할 수 없는 청크를 수동으로 마이그레이션할 수 있습니다. 자세한 내용은 moveChunk 명령을 참조하세요.

팁

다음도 참조하세요.

호환성

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

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

중요

이 명령은 서버리스 인스턴스에서는 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.

예제

records 데이터베이스의 people collection이 주어지면 다음 작업은 zipcode 필드가 53187 로 설정된 문서를 포함된 청크를 찾은 다음 해당 청크를 shard0019 라는 이름의 샤드로 이동합니다.

sh.moveChunk("records.people", { zipcode: "53187" }, "shard0019")

돌아가기

sh.isBalancerRunning

이 페이지의 내용