Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
참조
/
데이터베이스 명령
/
샤딩

샤드 나열

이 페이지의 내용

  • 정의
  • 호환성
  • 구문
  • 예시
  • 출력

정의

listShards

listShards 명령은 샤드 샤딩된 클러스터 에 구성된 샤드 목록을 반환합니다. listShards 는 mongos 인스턴스에서만 사용할 수 있으며 admin 데이터베이스 에 대해 발급해야 합니다.

호환성

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

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

중요

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

구문

명령은 다음과 같은 구문을 가집니다:

db.runCommand(
  {
    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",
      "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

    샤드가 속한 구역의 목록입니다.

    state

    클러스터에 샤드를 추가하는 데 필요한 모든 단계와 구성이 완료되었는지 확인하기 위해 addShard 시퀀스 중에 사용되는 내부 필드입니다.

  • 작업의 ok 상태 필드, operationTime 필드 및 $clusterTime 필드입니다. 이러한 필드에 대한 자세한 내용은 응답을 참조하세요.

돌아가기

isdbgrid

다음

mergeAllChunksOnShard

이 페이지의 내용