Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
참조
/
Mongo쉬 방법
/
샤딩

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>")

경고

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

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

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

호환성

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

  • MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

중요

이 명령은 서버리스 인스턴스에서는 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.

고려 사항

밸런싱

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

숨겨진 멤버

중요

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

DDL 작업

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

예시

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

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

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

돌아가기

sh.abortUnshardCollection

다음

sh.addShardTag

이 페이지의 내용