listDatabases

정의

listDatabases

listDatabases 명령은 모든 기존 데이터베이스 목록과 이에 대한 기본 통계를 제공합니다. listDatabases는 다음 예와 같이 admin 데이터베이스에 대해 실행되어야 합니다.

호환성

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

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

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

db.adminCommand( { listDatabases: 1 } )

값(예: 1은는 명령의 출력에 영향을 주지 않습니다.

명령 필드

이 명령은 다음과 같은 선택적 필드를 사용할 수 있습니다.

행동

인증이 활성화되면 listDatabases 명령은 명령을 실행하는 사용자에게 할당된 권한과 authorizedDatabases 명령 옵션에 따라 다른 값을 반환합니다.

• authorizedDatabases가 지정되지 않은 경우 및

  • 사용자가 클러스터 리소스에 대해 listDatabases 조치를 수행하는 경우 listDatabases 명령은 모든 데이터베이스를 반환합니다.

  • 사용자가 클러스터에 대해 listDatabases 조치를 수행하지 않는 경우 listDatabases 명령은 사용자에게 권한이 있는 데이터베이스만 반환합니다(사용자가 특정 컬렉션에 대한 권한이 있는 데이터베이스 포함).

• authorizedDatabases가 true인 경우 listDatabases 명령은 사용자에게 권한이 있는 데이터베이스만 반환합니다(사용자가 특정 컬렉션에 대한 권한을 보유한 데이터베이스 포함).

• authorizedDatabases가 false인 경우 및

  • 사용자가 클러스터에 대해 listDatabases 조치를 수행하는 경우 listDatabases 명령은 모든 데이터베이스를 반환합니다.

  • 사용자에게 클러스터에 대한 listDatabases 조치가 없는 경우, 권한 부족으로 인한 listDatabases 명령 오류가 발생합니다.

예시

db.adminCommand( { listDatabases: 1 } )

{
   "databases" : [
      {
         "name" : "admin",
         "sizeOnDisk" : 83886080,
         "empty" : false
      },
      {
         "name" : "local",
         "sizeOnDisk" : 83886080,
         "empty" : false
      },
      {
         "name" : "test",
         "sizeOnDisk" : 83886080,
         "empty" : false
      }
   ],
   "totalSize" : 251658240,
   "totalSizeMb" : 251,
   "ok" : 1
}

db.adminCommand( { listDatabases: 1, nameOnly: true} )

{
   "databases" : [
      {
         "name" : "admin"
      },
      {
         "name" : "local"
      },
      {
         "name" : "test"
      }
   ],
   "ok" : 1
}

db.adminCommand( { listDatabases: 1, filter: { "name": /^rep/ } } )

{
  "databases" : [
    {
      "name" : "admin",
      "sizeOnDisk" : 16384,
      "empty" : false,
      "shards" : {
        "config" : 16384
      }
    },
    {
      "name" : "config",
      "sizeOnDisk" : 176128,
      "empty" : false,
      "shards" : {
        "clients" : 28672,
        "patients" : 8192,
        "config" : 139264
      }
    },
    {
      "name" : "test",
      "sizeOnDisk" : 12288,
      "empty" : false,
      "shards" : {
        "clients" : 12288
      }
    }
  ],
  "totalSize" : 204800,
  "totalSizeMb" : 0,
  "ok" : 1
}

출력

listDatabases.databases

유형: 배열

단일 데이터베이스에 대한 정보를 각각 담고 있는 문서 배열입니다.

listDatabases.databases.name

유형: 문자열

데이터베이스의 이름입니다.

listDatabases.databases.sizeOnDisk

유형: 유형: 정수

디스크에 있는 데이터베이스 파일의 총 크기(바이트 단위)입니다.

listDatabases.databases.empty

유형: 부울

데이터베이스가 비어 있는지 여부를 지정합니다.

listDatabases.databases.shards

유형: 문서

shards 문서의 각 요소는 키가 해당 샤드의 collection 이름을 제공하고 값이 collection 크기(바이트)를 나타내는 필드로 구성됩니다.

shards nameOnly: false인 경우에만 출력에 나타납니다.

자세한 내용은 샤딩된 클러스터를 참조하세요.

listDatabases.totalSize

유형: 유형: 정수

모든 sizeOnDisk 필드의 합계입니다(바이트 단위).

listDatabases.totalSizeMb

유형: 유형: 정수

모든 sizeOnDisk 필드의 합계로, 메가바이트 단위로 표시됩니다.

listDatabases.ok

유형: 유형: 정수

명령의 반환 값입니다. 값이 1이면 성공입니다.