정의
sh.addShard(<url>)샤드 cluster 에 샤드 복제본 세트를 추가합니다. 이 메서드는
mongos인스턴스에서 실행되어야 합니다.중요
Mongo쉬 방법
This page documents a
mongoshmethod. This is not the documentation for database commands or language-specific drivers, such as Node.js.데이터베이스 명령에 대해서는
addShard명령을 참조하십시오.MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.
The
sh.addShard()method has the following parameter:Parameter유형설명host문자열
최소 한 명의 샤드 복제본 세트 멤버의 복제본 세트 이름, 호스트 이름 및 포트입니다. 모든 추가 복제본 세트 멤버 호스트 이름은 쉼표로 구분해야 합니다. 예를 들면 다음과 같습니다.
<replica_set>/<hostname><:port>,<hostname><:port>, ... The
sh.addShard()method has the following prototype form:sh.addShard("<replica_set>/<hostname><:port>") 경고
config 서버가
localhost에서도 실행 중인 경우가 아니라면 호스트 이름에localhost을 사용하지 마세요.mongos공식 Debian 및 Red Hat 또는 CentOS 패키지에서 설치된bind_ip127.0.0.1는 기본적으로 구성이 로 설정되어 있습니다.mongosuses"majority"for theaddShardcommand and its helpersh.addShard().
호환성
이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
- MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
중요
이 명령은 M0 및 Flex 클러스터에서 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
고려 사항
밸런싱
샤딩된 클러스터에 샤드를 추가하면 기존의 모든 샤드 컬렉션에 대한 클러스터의 샤드 간 청크 밸런스에 영향을 줍니다. 밸런서가 청크 마이그레이션을 시작하여 클러스터가 균형을 이룰 수 있도록 합니다. 자세한 내용은 밸런서 내부를 참조하세요.
숨겨진 멤버
중요
You cannot include a hidden member in the seed list provided to sh.addShard().
DDL 작업
클러스터 가 DDL 작업(예: 컬렉션 을 수정하는 작업 reshardCollection)을 실행하는 동안 sh.addShard 를 실행 하는 경우, sh.addShard 는 동시 DDL 작업이 완료된 후에만 실행됩니다.
예시
샤드를 추가하려면 복제본 세트의 이름과 복제본 세트 멤버 중 한 명 이상의 호스트 이름을 시드로 지정합니다. 추가 호스트 이름을 지정하는 경우 모두 동일한 복제본 세트의 멤버여야 합니다.
다음 예시에서는 repl0 (이)라는 이름의 복제본 세트를 추가하고 복제본 세트의 멤버 한 명을 지정합니다.
sh.addShard("repl0/mongodb3.example.net:27327")