문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼
sh.addShard()
정의
sh.addShard(<url>)
샤드 cluster 에 샤드 복제본 세트를 추가합니다. 이 메서드는
mongos
인스턴스에서 실행되어야 합니다.중요
Mongo쉬 방법
이 페이지에서는
mongosh
메서드를 설명합니다. 이는 데이터베이스 명령이나 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다 .데이터베이스 명령에 대해서는
addShard
명령을 참조하십시오.MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.
레거시
mongo
셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.sh.addShard()
메서드에는 다음과 같은 매개 변수가 있습니다.매개변수유형설명host
문자열최소 한 명의 샤드 복제본 세트 멤버의 복제본 세트 이름, 호스트 이름 및 포트입니다. 모든 추가 복제본 세트 멤버 호스트 이름은 쉼표로 구분해야 합니다. 예를 들면 다음과 같습니다.
<replica_set>/<hostname><:port>,<hostname><:port>, ... sh.addShard()
메서드의 프로토타입 형식은 다음과 같습니다.sh.addShard("<replica_set>/<hostname><:port>") 경고
mongos
"majority"
addShard
sh.addShard()
는명령과 해당 헬퍼 에 를 사용합니다.
고려 사항
밸런싱
샤드 클러스터에 샤드를 추가하면 기존의 모든 샤드 컬렉션에 대한 클러스터의 샤드 간 청크 밸런스에 영향을 줍니다. 밸런서가 청크 마이그레이션을 시작하여 클러스터가 균형을 이룰 수 있도록 합니다. 자세한 내용은 밸런서 내부를 참조하세요.
소스 샤드는 기본적으로 마이그레이션된 문서를 자동으로 보관하므로 청크 마이그레이션은 디스크 공간에 영향을 미칠 수 있습니다. 자세한 내용은 moveChunk
디렉토리를 참조하세요.
숨겨진 멤버
중요
에 sh.addShard()
제공된 시드 목록에 숨겨진 멤버 를 포함할 수 없습니다.
예제
샤드를 추가하려면 복제본 세트의 이름과 복제본 세트 멤버 중 한 명 이상의 호스트 이름을 시드로 지정합니다. 추가 호스트 이름을 지정하는 경우 모두 동일한 복제본 세트의 멤버여야 합니다.
다음 예시에서는 repl0
(이)라는 이름의 복제본 세트를 추가하고 복제본 세트의 멤버 한 명을 지정합니다.
sh.addShard("repl0/mongodb3.example.net:27327")