문서 메뉴

문서 홈애플리케이션 개발MongoDB 매뉴얼

sh.addShard()

이 페이지의 내용

  • 정의
  • 고려 사항
  • 예제
sh.addShard(<url>)

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

중요

Mongo쉬 방법

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

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

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

레거시 mongo 셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.

Mongo 셸 V4.4

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

매개변수
유형
설명
host
문자열

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

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

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

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

경고

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

공식 .deb 에서 mongos 설치 및 .rpm 패키지는 기본적으로 bind_ip 구성을 127.0.0.1 로 설정합니다.

mongos "majority" addShard sh.addShard()명령과 해당 헬퍼 에 를 사용합니다.

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

소스 샤드는 기본적으로 마이그레이션된 문서를 자동으로 보관하므로 청크 마이그레이션은 디스크 공간에 영향을 미칠 수 있습니다. 자세한 내용은 moveChunk 디렉토리를 참조하세요.

중요

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

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

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

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

이 페이지의 내용