sh.addShard() (mongosh 메서드)

정의

sh.addShard(<url>)

샤드 cluster 에 샤드 복제본 세트를 추가합니다. 이 메서드는 mongos 인스턴스에서 실행되어야 합니다.

중요

Mongo쉬 방법

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

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

sh.addShard() 메서드에는 다음과 같은 매개변수가 있습니다:

Parameter

유형

설명

host

문자열

최소 한 명의 샤드 복제본 세트 멤버의 복제본 세트 이름, 호스트 이름 및 포트입니다. 모든 추가 복제본 세트 멤버 호스트 이름은 쉼표로 구분해야 합니다. 예를 들면 다음과 같습니다.

<replica_set>/<hostname><:port>,<hostname><:port>, ...

sh.addShard() 메서드의 프로토타입 형식은 다음과 같습니다.

sh.addShard("<replica_set>/<hostname><:port>")

경고

config 서버가 localhost 에서도 실행 중인 경우가 아니라면 호스트 이름에 localhost 을 사용하지 마세요.

mongos 공식 Debian 및 Red Hat 또는 CentOS 패키지에서 설치된 bind_ip 127.0.0.1 는 기본적으로 구성이 로 설정되어 있습니다.

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

중요

이 명령은 M0 및 Flex 클러스터에서 지원되지 않습니다.자세한 내용은 지원되지 않는 명령을 참조하세요.

샤딩된 클러스터에 샤드를 추가하면 기존의 모든 샤드 컬렉션에 대한 클러스터의 샤드 간 청크 밸런스에 영향을 줍니다. 밸런서가 청크 마이그레이션을 시작하여 클러스터가 균형을 이룰 수 있도록 합니다. 자세한 내용은 밸런서 내부를 참조하세요.

중요

sh.addShard()에 제공된 시드 목록 에 숨겨진 멤버 포함할 수 없습니다.

클러스터 가 DDL 작업(예: 컬렉션 을 수정하는 작업 reshardCollection)을 실행하는 동안 sh.addShard 를 실행 하는 경우, sh.addShard 는 동시 DDL 작업이 완료된 후에만 실행됩니다.

샤드를 추가하려면 복제본 세트의 이름과 복제본 세트 멤버 중 한 명 이상의 호스트 이름을 시드로 지정합니다. 추가 호스트 이름을 지정하는 경우 모두 동일한 복제본 세트의 멤버여야 합니다.

다음 예시에서는 repl0 (이)라는 이름의 복제본 세트를 추가하고 복제본 세트의 멤버 한 명을 지정합니다.

sh.addShard("repl0/mongodb3.example.net:27327")