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