문서 메뉴

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

sh.enableSharding()

이 페이지의 내용

  • 정의
  • 호환성
  • 구문
  • 행동
  • 예제

정의

sh.enableSharding(database, primaryShard)

참고

버전 6.0에서 변경되었습니다.

MongoDB 6.0부터는 컬렉션을 샤딩할 때 이 메서드가 필요하지 않습니다.

명시적으로 데이터베이스를 생성합니다. mongosh 메서드 sh.shardCollection() 를 사용하여 데이터베이스에서 컬렉션을 샤딩합니다. mongosh 메서드 sh.enableSharding() 는 enableSharding 명령을 래핑합니다.

중요

Mongo쉬 방법

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

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

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

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

Mongo 셸 V4.4

호환성

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

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

참고

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

구문

sh.enableSharding() 의 형식은 다음과 같습니다.

sh.enableSharding(
   <database>,
   <primary shard>  // Optional. Available starting in MongoDB 4.2.2 (and 4.0.14)
)

매개변수

sh.enableSharding() 메서드는 다음 매개 변수를 사용합니다.

매개변수
유형
설명
데이터베이스
문자열

생성하려는 데이터베이스의 이름입니다.

primaryShard
문자열

선택 사항입니다. 데이터베이스의 프라이머리 샤드이며 여기에는 이 데이터베이스에 대한 샤딩되지 않은 컬렉션이 포함되어 있습니다. 일반적으로 프라이머리 샤드를 명시적으로 지정하는 것보다 밸런서가 프라이머리 샤드를 대신 선택하도록 하는 것이 좋습니다.

경고

팁

일반적으로 프라이머리 샤드를 지정할 필요는 없습니다. 밸런서가 대신 프라이머리 샤드를 선택하도록 허용합니다.

MongoDB 4.2.2(및 4.0.14)부터 사용 가능

행동

쓰기 고려

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

프라이머리 샤드

일반적으로 명령에 프라이머리 샤드 를 지정할 필요가 없습니다. 대신 밸런서가 프라이머리 샤드를 선택하도록 허용합니다.

그러나 데이터베이스의 프라이머리 샤드 를 지정하고 데이터베이스가 이미 다른 프라이머리 샤드로 샤딩을 사용하도록 설정되어 있는 경우, 작업은 오류를 반환하고 데이터베이스의 프라이머리 샤드는 이전과 동일하게 유지됩니다. 데이터베이스의 프라이머리 샤드를 변경하려면 movePrimary 명령을 대신 사용합니다.

예제

mongos에서 실행되는 다음 예시는 명시적으로 shardTest 데이터베이스를 생성합니다.

sh.enableSharding("shardTest")

확인하려면 sh.status()를 실행합니다.

팁

다음도 참조하세요.

← sh.enableAutoSplit
sh.getBalancerState() →

이 페이지의 내용