Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
참조
/
Mongo쉬 방법
/
컬렉션

db.collection.getShardDistribution()

이 페이지의 내용

정의

db.collection.getShardDistribution()

중요

Mongo쉬 방법

이는 mongosh 메서드입니다. 이는 Node.js 또는 기타 프로그래밍 언어별 드라이버 메서드에 대한 설명서가 아닙니다 .

대부분의 경우 mongosh 메서드는 레거시 mongo shell 메서드와 동일한 방식으로 작동합니다. 그러나 일부 레거시 메서드는 mongosh 에서 사용할 수 없습니다.

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

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

샤드 컬렉션에 대한 데이터 배포 통계를 출력합니다.

호환성

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

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

중요

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

구문

getShardDistribution() 메서드의 형식은 다음과 같습니다.

db.collection.getShardDistribution()

팁

다음도 참조하세요.

샤딩

출력

샘플 출력

다음은 샤드 컬렉션의 배포에 대한 샘플 출력입니다.

Shard shard-a at shard-a/MyMachine.local:30000,MyMachine.local:30001,MyMachine.local:30002
data : 38.14Mb docs : 1000003 chunks : 2
estimated data per chunk : 19.07Mb
estimated docs per chunk : 500001
Shard shard-b at shard-b/MyMachine.local:30100,MyMachine.local:30101,MyMachine.local:30102
data : 38.14Mb docs : 999999 chunks : 3
estimated data per chunk : 12.71Mb
estimated docs per chunk : 333333
Totals
data : 76.29Mb docs : 2000002 chunks : 5
Shard shard-a contains 50% data, 50% docs in cluster, avg obj size on shard : 40b
Shard shard-b contains 49.99% data, 49.99% docs in cluster, avg obj size on shard : 40b

출력 필드

Shard <shard-a> at <host-a>
 data : <size-a> docs : <count-a> chunks : <number of chunks-a>
 estimated data per chunk : <size-a>/<number of chunks-a>
 estimated docs per chunk : <count-a>/<number of chunks-a>
Shard <shard-b> at <host-b>
 data : <size-b> docs : <count-b> chunks : <number of chunks-b>
 estimated data per chunk : <size-b>/<number of chunks-b>
 estimated docs per chunk : <count-b>/<number of chunks-b>
Totals
 data : <stats.size> docs : <stats.count> chunks : <calc total chunks>
 Shard <shard-a> contains  <estDataPercent-a>% data, <estDocPercent-a>% docs in cluster, avg obj size on shard : stats.shards[ <shard-a> ].avgObjSize
 Shard <shard-b> contains  <estDataPercent-b>% data, <estDocPercent-b>% docs in cluster, avg obj size on shard : stats.shards[ <shard-b> ].avgObjSize

출력 정보는 다음과 같이 표시됩니다.

  • <shard-x> 샤드 이름이 저장된 문자열입니다.

  • <host-x> 호스트 이름이 포함된 문자열입니다.

  • <size-x> 측정 단위를 포함하여 데이터의 크기를 포함하는 숫자입니다(예: b, Mb).

  • <count-x> 샤드에 있는 문서 수를 보고하는 숫자입니다.

  • <number of chunks-x> 샤드에 있는 청크의 수를 나타내는 숫자입니다.

  • <size-x>/<number of chunks-x> 측정 단위를 포함하여 샤드에 대한 청크당 예상 데이터 크기를 반영하는 계산된 값입니다(예: b, Mb).

  • <count-x>/<number of chunks-x> 샤드의 청크당 예상 문서 수를 반영하여 계산된 값입니다.

  • <stats.size> 측정 단위를 포함하여 샤드 컬렉션에 있는 데이터의 전체 크기를 보고하는 값입니다.

  • <stats.count> 샤드 컬렉션의 총 문서 수를 보고하는 값입니다.

  • <calc total chunks> 모든 샤드의 청크 수를 보고하는 계산된 숫자입니다. 예를 들어 다음과 같습니다.

    <calc total chunks> = <number of chunks-a> + <number of chunks-b>

  • <estDataPercent-x> 각 샤드에 대해 데이터 크기를 컬렉션의 전체 데이터 크기에 대한 백분율로 반영하는 계산된 값입니다. 예를 들어 다음과 같습니다.

    <estDataPercent-x> = <size-x>/<stats.size>

  • <estDocPercent-x> 각 샤드에 대한 문서 수를 컬렉션의 총 문서 수의 백분율로 반영하는 계산된 값입니다. 예를 들면 다음과 같습니다.

    <estDocPercent-x> = <count-x>/<stats.count>

  • stats.shards[ <shard-x> ].avgObjSize 측정 단위를 포함한 샤드의 평균 객체 크기를 반영하는 숫자입니다.

돌아가기

db.collection.getIndexes()

다음

db.collection.getShardVersion

이 페이지의 내용