dbStats (데이터베이스 명령)

정의

dbStats

The dbStats command returns storage statistics for a given database.

호환성

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

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

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

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

구문

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

db.runCommand(
   {
     dbStats: 1,
     scale: <number>,
     freeStorage: 0
   }
)

명령 필드

이 명령은 다음 필드를 사용합니다.

mongosh에서 db.stats() 함수는 dbStats에 대한 래퍼(wrapper)를 제공합니다.

행동

명령을 실행하는 데 필요한 시간은 데이터베이스의 총 크기에 따라 달라집니다. 명령은 모든 데이터 파일을 처리해야 하므로 명령을 실행하는 데 몇 초 정도 걸릴 수 있습니다.

출력

dbStats.db

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

dbStats.collections

데이터베이스에 있는 컬렉션의 수입니다.

dbStats.views

데이터베이스의 뷰 수입니다.

dbStats.objects

모든 컬렉션의 데이터베이스에 있는 객체(특히, 문서)의 수입니다.

dbStats.avgObjSize

Average size of each document in bytes. This is the dataSize divided by the number of documents. The scale argument does not affect the avgObjSize value.

dbStats.dataSize

Total size of the uncompressed data held in the database. The dataSize decreases when you remove documents.

압축이 활성화된 경우 WiredTiger 스토리지 엔진을 사용하는 데이터베이스의 경우 dataSize가 storageSize보다 클 수 있습니다. 문서가 축소되면 dataSize가 감소합니다.

dbStats.storageSize

여유 공간을 포함하여 문서 저장을 위해 데이터베이스의 모든 컬렉션에 할당된 디스크 공간의 합계입니다.

The storageSize does not decrease as you remove or shrink documents. This value may be smaller than dataSize for databases using the WiredTiger storage engine with compression enabled.

storageSize does not include space allocated to indexes. See indexSize for the total index size.

dbStats.freeStorageSize

문서 저장을 위해 데이터베이스의 모든 컬렉션에 할당된 여유 공간의 합계입니다. 컬렉션에 여유 데이터베이스 저장 공간이 할당되었지만 데이터가 포함되어 있지 않습니다.

freeStorageSize does not include free space allocated to indexes. See indexFreeStorageSize for the total free index size.

To include this value in the dbStats output, set freeStorage to 1.

버전 5.3.0, 5.2.1, 및 5.0.6에서 업데이트됨

dbStats.indexes

데이터베이스에 있는 모든 컬렉션의 총 인덱스 수입니다.

dbStats.indexSize

사용 가능한 인덱스 공간을 포함하여 데이터베이스의 모든 인덱스에 할당된 디스크 공간의 합계입니다.

참고

필드 에 기본값 인덱스 만 있는 클러스터형 _ìd 컬렉션( 세컨더리 인덱스 없음)에서는 컬렉션 에 별도의 인덱스 파일 필요하지 않기 때문에 인덱스 크기가 0으로 표시됩니다.

dbStats.indexFreeStorageSize

데이터베이스의 모든 인덱스에 할당된 여유 디스크 공간의 합계입니다. 데이터베이스 저장소 여유 공간은 인덱스에 할당되지만 데이터는 포함하지 않습니다.

indexFreeStorageSize does not include free space allocated to document storage. See freeStorageSize for the total free document storage size.

indexFreeStorageSize 진행 중인 인덱스 빌드가 포함되지 않습니다.

To include this value in the dbStats output, set freeStorage to 1.

버전 7.0, 6.3.2, 6.0.7, 5.3.0, 5.2.1, 5.0.19 및 5.0.6에서 업데이트되었습니다.

dbStats.totalSize

Sum of the disk space allocated for both documents and indexes in all collections in the database. Includes used and free storage space. This is the sum of storageSize and indexSize.

dbStats.totalFreeStorageSize

Sum of the free storage space allocated for both documents and indexes in all collections in the database. This is the sum of freeStorageSize and indexFreeStorageSize.

To include this value in the dbStats output, set freeStorage to 1.

버전 5.3.0, 5.2.1, 및 5.0.6에서 업데이트되었습니다,

dbStats.scaleFactor

scale 명령에 사용되는 값입니다.

정수가 아닌 배율 인수를 지정한 경우 MongoDB는 지정된 인수의 정수 부분을 사용합니다. 예를 들어, 배율 인수를 1023.999로 지정하면 MongoDB는 배율 인수로 1023을 사용합니다.

dbStats.fsUsedSize

MongoDB가 데이터를 저장하는 파일 시스템에서 사용 중인 모든 디스크 공간의 총 크기입니다.

팁

--dbpath

dbStats.fsTotalSize

MongoDB가 데이터를 저장하는 파일시스템의 모든 디스크 용량의 총 크기입니다.

예시

The following examples demonstrate dbStats usage.

db.runCommand( { dbStats: 1 } ).indexSize

db.runCommand( { dbStats: 1, scale: 1024, freeStorage: 1 } )

{
  db: 'test',
  collections: 2,
  views: 0,
  objects: 1689,
  avgObjSize: 52.56542332741267,
  dataSize: 86.7021484375,
  storageSize: 100,
  freeStorageSize: 32,
  indexes: 2,
  indexSize: 116,
  indexFreeStorageSize: 36,
  totalSize: 216,
  totalFreeStorageSize: 68,
  scaleFactor: 1024,
  fsUsedSize: 60155820,
  fsTotalSize: 61255492,
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp({ t: 1646085664, i: 1 }),
    signature: {
      hash: Binary(Buffer.from("0000000000000000000000000000000000000000", "hex"), 0),
      keyId: Long("0")
    }
  },
  operationTime: Timestamp({ t: 1646085664, i: 1 })
}