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

sh.enableSharding()

이 페이지의 내용

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

정의

sh.enableSharding(database, primaryShard)

지정된 데이터베이스 에서 샤딩 을 활성화합니다. 데이터베이스 에 대해 샤딩 을 활성화한 후에는 를 sh.shardCollection() 사용하여 해당 데이터베이스 mongosh sh.enableSharding() 의 컬렉션을 샤드 enableSharding 할 수 있습니다. 메서드 는 명령을 래핑합니다.

중요

Mongo쉬 방법

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

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

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

호환성

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

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

중요

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

구문

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

sh.enableSharding(
   <database>,
   <primary shard>  // Optional.
)

Parameter

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

Parameter
유형
설명

database

문자열

샤딩을 활성화하려는 데이터베이스입니다.

primaryShard

문자열

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

경고

팁

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

행동

쓰기 고려

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

프라이머리 샤드

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

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

예시

mongos 에서 실행되는 다음 예제는 test 데이터베이스에 대한 샤딩을 활성화합니다.

sh.enableSharding("test")

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

팁

다음도 참조하세요.

돌아가기

sh.enableAutoSplit

다음

sh.getBalancerState

이 페이지의 내용