정의
listShardslistShards명령은 샤딩된 클러스터 에 구성된 샤드 목록을 반환합니다.listShardsmongos는admin인스턴스에서만 사용할 수 있으며 데이터베이스 에 대해 발급해야 합니다.
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
중요
이 명령은 서버리스 인스턴스에서는 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
구문
명령은 다음과 같은 구문을 가집니다:
{ listShards: 1 }
예시
다음 작업은 listShards mongos admin 데이터베이스에 대해 를 실행합니다.
db.adminCommand({ listShards: 1 })
다음 문서는 listShards 명령의 출력 예시입니다.
{ "shards": [ { "_id": "shard01", "host": "shard01/host1:27018,host2:27018,host3:27018", "state": 1 }, { "_id": "shard02", "host": "shard02/host4:27018,host5:27018,host6:27018", "tags": [ "NYC" ], "state": 1 }, { "_id": "shard03", "host": "shard03/host7:27018,host8:27018,host9:27018", "maxSize": NumberLong("1024"), "state": 1 } ], "ok": 1, "$clusterTime" : { "clusterTime" : Timestamp(1510716515, 1), "signature" : { "hash" : BinData(0,"B2ViX7XLzFLS5Fl9XEuFXbwKIM4="), "keyId" : NumberLong("6488045157173166092") } }, "operationTime" : Timestamp(1510716515, 1) }
출력
listShards 다음을 포함하는 문서를 반환합니다.
각각 샤드 하나를 설명하는 문서 배열을 포함하는
shards필드입니다. 각 문서에는 다음과 같은 필드가 포함되어 있습니다.필드설명_id샤드의 이름입니다.
host샤드의 호스트 이름입니다. 샤드가 복제본 세트인 경우
host복제본 세트에 있는 각 mongod 인스턴스의 호스트 이름을 나열합니다.draining참이면, 이 샤드에 대해 removeShardㄱ 호출되었으며 샤드가 비워지는 중임을 나타냅니다.
tags샤드가 속한 구역의 목록입니다.
maxSize샤드에 구성된 최대 스토리지 크기(MB)입니다. 여기에는
local및admin데이터베이스를 포함하여 샤드의 모든 데이터 파일이 포함됩니다. 이를 초과하면 이 샤드는 더 이상 청크를 수신하지 않습니다.state클러스터에 샤드를 추가하는 데 필요한 모든 단계와 구성이 완료되었는지 확인하기 위해 addShard 시퀀스 중에 사용되는 내부 필드입니다.
작업의
ok상태 필드,operationTime필드 및$clusterTime필드입니다. 이러한 필드에 대한 자세한 내용은 응답을 참조하세요.