db.collection.stats（）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > mongo Shell方法 > 收集方法 > db.collection.stats（）

在本页面

定义
行为
例子

定义¶

db.collection.stats（<选项> ）¶

mongo 壳法

此页面记录了mongoshell方法，并且没有引用MongoDB Node.js驱动程序（或任何其他驱动程序）方法。对于相应的MongoDB驱动程序API，请改为参考您特定的 MongoDB驱动程序文档。

返回有关集合的统计信息。

该方法具有以下格式：

复制

db.collection.stats({
   scale: <num>,                   // Optional
   indexDetails: <boolean>,        // Optional
   indexDetailsKey: <document>,    // Optional
   indexDetailsName: <string>.     // Optional
})

领域	类型	描述
`scale`	数	可选的。各种尺寸数据的比例因子。该`scale`缺省值为1以字节返回大小的数据。要显示千字节而不是字节，请指定`scale`值`1024`。如果您指定非整数比例因子，则MongoDB将使用指定因子的整数部分。例如，如果将比例因子指定为`1023.999`，则MongoDB将使用`1023`该比例因子。从4.2版开始，输出包括`scaleFactor` 用于缩放尺寸值的输出。
`indexDetails`	布尔值	可选的。如果为`true`，则除收集统计信息外，还`db.collection.stats()`返回。`index details` 仅适用于WiredTiger存储引擎。默认为`false`。
`indexDetailsKey`	文献	可选的。如果`indexDetails`为`true`，则可以`indexDetailsKey`通过指定索引键规范来过滤索引详细信息。仅`indexDetailsKey`返回完全匹配的索引。如果找不到匹配项，`indexDetails`将显示所有索引的统计信息。使用`getIndexes()`发现索引键。您不能`indexDetailsKey`与一起使用`indexDetailsName`。
`indexDetailsName`	串	可选的。如果`indexDetails`是`true`，则可以`indexDetailsName`通过指定索引来过滤索引详细信息`name`。仅`indexDetailsName`返回完全匹配的索引名称。如果找不到匹配项，`indexDetails`将显示所有索引的统计信息。使用`getIndexes()`发现索引名。您不能`indexDetailsName`与一起使用`indexDetailsField`。

仅指定scale因素，MongoDB支持旧格式：

复制

db.collection.stats(<number>)

返回值：	包含有关指定集合的统计信息的文档。请参阅`collStats`以获取返回统计信息的细分。

该db.collection.stats()方法提供了围绕数据库命令的包装collStats。

行为¶

缩放大小¶

除非度量标准名称（例如）另外指定，否则与大小相关的值以字节显示，并且可以被覆盖。"bytes currently in the cache"scale

比例因子将受影响的大小值四舍五入为整数。

存储引擎¶

根据存储引擎的不同，返回的数据可能会有所不同。有关字段的详细信息，请参见输出详细信息。

意外关机后的精度¶

mongod使用Wired Tiger存储引擎不正常关闭后，所报告的数量和大小统计信息 db.collection.stats()可能不准确。

漂移量取决于在最后一个检查点与异常关闭之间执行的插入，更新或删除操作的数量。检查点通常每60秒出现一次。但是，mongod使用非默认--syncdelay设置运行的实例可能具有或多或少的频繁检查点。

validate在mongod 不正常关机后，对上的每个集合运行以恢复正确的统计信息。

索引过滤器行为¶

indexDetails使用indexDetailsKey或进行过滤indexDetailsName只会返回一个匹配的索引。如果未找到完全匹配的内容，indexDetails将在集合的所有索引上显示信息。

该indexDetailsKey字段采用以下格式的文档：

复制

{ '<string>' : <value>, '<string>' : <value>, ... }

在哪里<string>>索引的字段是索引<value>的方向，还是特殊的索引类型（例如text或） 2dsphere。有关索引类型的完整列表，请参见索引类型。

意外的关机和计数¶

对于使用MongoDB的情况下WiredTiger 存储引擎，不正常关机后，由多达1000个文档的大小和数量可能关闭统计所报告的collStats， dbStats，count。要为集合还原正确的统计信息，请在集合上运行validate。

进行中索引¶

从MongoDB 4.2开始，db.collection.stats包括有关当前正在构建的索引的信息。有关详细信息，请参见：

例子¶

注意

您可以在我们的primer-dataset.json中找到用于这些示例的收集数据

基本统计资料查找¶

以下操作返回数据库中restaurants集合的统计信息test：

复制

db.restaurants.stats()

该操作返回：

复制

{
   "ns" : "test.restaurants",
   "size" : 10624215,
   "count" : 25359,
   "avgObjSize" : 418,
   "storageSize" : 3801088,
   "capped" : false,
   "wiredTiger" : {
         "metadata" : {
            "formatVersion" : 1
         },
         "creationString" : "access_pattern_hint=none,allocation_size=4KB,app_metadata=(formatVersion=1),assert=(commit_timestamp=none,read_timestamp=none),block_allocation=best,block_compressor=snappy,cache_resident=false,checksum=on,colgroups=,collator=,columns=,dictionary=0,encryption=(keyid=,name=),exclusive=false,extractor=,format=btree,huffman_key=,huffman_value=,ignore_in_memory_cache_size=false,immutable=false,internal_item_max=0,internal_key_max=0,internal_key_truncate=true,internal_page_max=4KB,key_format=q,key_gap=10,leaf_item_max=0,leaf_key_max=0,leaf_page_max=32KB,leaf_value_max=64MB,log=(enabled=true),lsm=(auto_throttle=true,bloom=true,bloom_bit_count=16,bloom_config=,bloom_hash_count=8,bloom_oldest=false,chunk_count_limit=0,chunk_max=5GB,chunk_size=10MB,merge_custom=(prefix=,start_generation=0,suffix=),merge_max=15,merge_min=0),memory_page_image_max=0,memory_page_max=10m,os_cache_dirty_max=0,os_cache_max=0,prefix_compression=false,prefix_compression_min=4,source=,split_deepen_min_child=0,split_deepen_per_child=0,split_pct=90,type=file,value_format=u",
         "type" : "file",
         "uri" : "statistics:table:collection-13--5172949556175635116",
         "LSM" : {
            "bloom filter false positives" : 0,
            "bloom filter hits" : 0,
            "bloom filter misses" : 0,
            "bloom filter pages evicted from cache" : 0,
            "bloom filter pages read into cache" : 0,
            "bloom filters in the LSM tree" : 0,
            "chunks in the LSM tree" : 0,
            "highest merge generation in the LSM tree" : 0,
            "queries that could have benefited from a Bloom filter that did not exist" : 0,
            "sleep for LSM checkpoint throttle" : 0,
            "sleep for LSM merge throttle" : 0,
            "total size of bloom filters" : 0
         },
         "block-manager" : {
            "allocations requiring file extension" : 0,
            "blocks allocated" : 0,
            "blocks freed" : 0,
            "checkpoint size" : 0,
            "file allocation unit size" : 4096,
            "file bytes available for reuse" : 0,
            "file magic number" : 120897,
            "file major version number" : 1,
            "file size in bytes" : 4096,
            "minor version number" : 0
         },
         "btree" : {
            "btree checkpoint generation" : 0,
            "column-store fixed-size leaf pages" : 0,
            "column-store internal pages" : 0,
            "column-store variable-size RLE encoded values" : 0,
            "column-store variable-size deleted values" : 0,
            "column-store variable-size leaf pages" : 0,
            "fixed-record size" : 0,
            "maximum internal page key size" : 368,
            "maximum internal page size" : 4096,
            "maximum leaf page key size" : 2867,
            "maximum leaf page size" : 32768,
            "maximum leaf page value size" : 67108864,
            "maximum tree depth" : 3,
            "number of key/value pairs" : 0,
            "overflow pages" : 0,
            "pages rewritten by compaction" : 0,
            "row-store internal pages" : 0,
            "row-store leaf pages" : 0
         },
         "cache" : {
            "bytes currently in the cache" : 13522657,
            "bytes dirty in the cache cumulative" : 1288,
            "bytes read into cache" : 0,
            "bytes written from cache" : 0,
            "checkpoint blocked page eviction" : 0,
            "data source pages selected for eviction unable to be evicted" : 0,
            "eviction walk passes of a file" : 0,
            "eviction walk target pages histogram - 0-9" : 0,
            "eviction walk target pages histogram - 10-31" : 0,
            "eviction walk target pages histogram - 128 and higher" : 0,
            "eviction walk target pages histogram - 32-63" : 0,
            "eviction walk target pages histogram - 64-128" : 0,
            "eviction walks abandoned" : 0,
            "eviction walks gave up because they restarted their walk twice" : 0,
            "eviction walks gave up because they saw too many pages and found no candidates" : 0,
            "eviction walks gave up because they saw too many pages and found too few candidates" : 0,
            "eviction walks reached end of tree" : 0,
            "eviction walks started from root of tree" : 0,
            "eviction walks started from saved location in tree" : 0,
            "hazard pointer blocked page eviction" : 0,
            "in-memory page passed criteria to be split" : 2,
            "in-memory page splits" : 1,
            "internal pages evicted" : 0,
            "internal pages split during eviction" : 0,
            "leaf pages split during eviction" : 0,
            "modified pages evicted" : 0,
            "overflow pages read into cache" : 0,
            "page split during eviction deepened the tree" : 0,
            "page written requiring cache overflow records" : 0,
            "pages read into cache" : 0,
            "pages read into cache after truncate" : 1,
            "pages read into cache after truncate in prepare state" : 0,
            "pages read into cache requiring cache overflow entries" : 0,
            "pages requested from the cache" : 25961,
            "pages seen by eviction walk" : 0,
            "pages written from cache" : 0,
            "pages written requiring in-memory restoration" : 0,
            "tracked dirty bytes in the cache" : 13522657,
            "unmodified pages evicted" : 0
         },
         "cache_walk" : {
            "Average difference between current eviction generation when the page was last considered" : 0,
            "Average on-disk page image size seen" : 0,
            "Average time in cache for pages that have been visited by the eviction server" : 0,
            "Average time in cache for pages that have not been visited by the eviction server" : 0,
            "Clean pages currently in cache" : 0,
            "Current eviction generation" : 0,
            "Dirty pages currently in cache" : 0,
            "Entries in the root page" : 0,
            "Internal pages currently in cache" : 0,
            "Leaf pages currently in cache" : 0,
            "Maximum difference between current eviction generation when the page was last considered" : 0,
            "Maximum page size seen" : 0,
            "Minimum on-disk page image size seen" : 0,
            "Number of pages never visited by eviction server" : 0,
            "On-disk page image sizes smaller than a single allocation unit" : 0,
            "Pages created in memory and never written" : 0,
            "Pages currently queued for eviction" : 0,
            "Pages that could not be queued for eviction" : 0,
            "Refs skipped during cache traversal" : 0,
            "Size of the root page" : 0,
            "Total number of pages currently in cache" : 0
         },
         "compression" : {
            "compressed pages read" : 0,
            "compressed pages written" : 0,
            "page written failed to compress" : 0,
            "page written was too small to compress" : 0
         },
         "cursor" : {
            "bulk-loaded cursor-insert calls" : 0,
            "close calls that result in cache" : 0,
            "create calls" : 1,
            "cursor operation restarted" : 0,
            "cursor-insert key and value bytes inserted" : 10691718,
            "cursor-remove key bytes removed" : 0,
            "cursor-update value bytes updated" : 0,
            "cursors reused from cache" : 28,
            "insert calls" : 25359,
            "modify calls" : 0,
            "next calls" : 76080,
            "open cursor count" : 0,
            "prev calls" : 1,
            "remove calls" : 0,
            "reserve calls" : 0,
            "reset calls" : 1034,
            "search calls" : 0,
            "search near calls" : 595,
            "truncate calls" : 0,
            "update calls" : 0
         },
         "reconciliation" : {
            "dictionary matches" : 0,
            "fast-path pages deleted" : 0,
            "internal page key bytes discarded using suffix compression" : 0,
            "internal page multi-block writes" : 0,
            "internal-page overflow keys" : 0,
            "leaf page key bytes discarded using prefix compression" : 0,
            "leaf page multi-block writes" : 0,
            "leaf-page overflow keys" : 0,
            "maximum blocks required for a page" : 0,
            "overflow values written" : 0,
            "page checksum matches" : 0,
            "page reconciliation calls" : 0,
            "page reconciliation calls for eviction" : 0,
            "pages deleted" : 0
         },
         "session" : {
            "object compaction" : 0
         },
         "transaction" : {
            "update conflicts" : 0
         }
   },
   "nindexes" : 4,
   "indexBuilds" : [ ],  // Available starting in MongoDB 4.2
   "totalIndexSize" : 684032s,
   "indexSizes" : {
      "_id_" : 237568,
      "cuisine_1" : 143360,
      "borough_1_cuisine_1" : 151552,
      "borough_1_address.zipcode_1" : 151552
   },
   "scaleFactor" : 1,   // Available starting in MongODB 4.2
   "ok" : 1
}

由于统计信息未提供比例参数，因此所有尺寸值均在中bytes。

带刻度的统计查询¶

以下的动作从改变数据的比例bytes，以kilobytes 通过指定scale的1024：

复制

db.restaurants.stats( { scale : 1024 } )

该操作返回：

复制

{
   "ns" : "test.restaurants",
   "size" : 10375,
   "count" : 25359,
   "avgObjSize" : 418,
   "storageSize" : 3712,
   "capped" : false,
   "wiredTiger" : {
      ...
   },
   "nindexes" : 4,
   "indexBuilds" : [ ],  // Available starting in MongoDB 4.2
   "totalIndexSize" : 668,
   "indexSizes" : {
      "_id_" : 232,
      "cuisine_1" : 140,
      "borough_1_cuisine_1" : 148,
      "borough_1_address.zipcode_1" : 148
   },
   "scaleFactor" : 1024, // Available starting in MongoDB 4.2
   "ok" : 1
}

统计查询索引详细¶

以下操作将创建一个indexDetails文档，其中包含与集合中每个索引有关的信息：

复制

db.restaurants.stats( { indexDetails : true } )

该操作返回：

复制

{
   "ns" : "test.restaurants",
   "size" : 10624215,
   "count" : 25359,
   "avgObjSize" : 418,
   "storageSize" : 3801088,
   "capped" : false,
   "wiredTiger" : {
   ...
   }
   "nindexes" : 4,
   "indexDetails" : {
      "_id_" : {
         "metadata" : {
            "formatVersion" : 8,
            "infoObj" : "{ \"v\" : 2, \"key\" : { \"_id\" : 1 }, \"name\" : \"_id_\", \"ns\" : \"test.restaurants\" }"
         },
         "creationString" : "access_pattern_hint=none,allocation_size=4KB,app_metadata=(formatVersion=8,infoObj={ \"v\" : 2, \"key\" : { \"_id\" : 1 }, \"name\" : \"_id_\", \"ns\" : \"test.restaurants\" }),assert=(commit_timestamp=none,read_timestamp=none),block_allocation=best,block_compressor=,cache_resident=false,checksum=on,colgroups=,collator=,columns=,dictionary=0,encryption=(keyid=,name=),exclusive=false,extractor=,format=btree,huffman_key=,huffman_value=,ignore_in_memory_cache_size=false,immutable=false,internal_item_max=0,internal_key_max=0,internal_key_truncate=true,internal_page_max=16k,key_format=u,key_gap=10,leaf_item_max=0,leaf_key_max=0,leaf_page_max=16k,leaf_value_max=0,log=(enabled=true),lsm=(auto_throttle=true,bloom=true,bloom_bit_count=16,bloom_config=,bloom_hash_count=8,bloom_oldest=false,chunk_count_limit=0,chunk_max=5GB,chunk_size=10MB,merge_custom=(prefix=,start_generation=0,suffix=),merge_max=15,merge_min=0),memory_page_image_max=0,memory_page_max=5MB,os_cache_dirty_max=0,os_cache_max=0,prefix_compression=true,prefix_compression_min=4,source=,split_deepen_min_child=0,split_deepen_per_child=0,split_pct=90,type=file,value_format=u",
         "type" : "file",
         "uri" : "statistics:table:index-14--5172949556175635116",
         "LSM" : {
         ...
         },
         "block-manager" : {
         ...
         },
         "btree" : {
         ...
         },
         "cache" : {
         ...
         },
         "cache_walk" : {
         ...
         },
         "compression" : {
         ...
         },
         "cursor" : {
         ...

         },
         "reconciliation" : {
         ...
         },
         "session" : {
         ...
         },
         "transaction" : {
            "update conflicts" : 0
         }
      },
      "cuisine_1" : {
         "metadata" : {
            "formatVersion" : 8,
            "infoObj" : "{ \"v\" : 2, \"key\" : { \"cuisine\" : 1 }, \"name\" : \"cuisine_1\", \"ns\" : \"test.restaurants\" }"
         },
         ...
      },
      "borough_1_cuisine_1" : {
         "metadata" : {
            "formatVersion" : 8,
            "infoObj" : "{ \"v\" : 2, \"key\" : { \"borough\" : 1, \"cuisine\" : 1 }, \"name\" : \"borough_1_cuisine_1\", \"ns\" : \"test.restaurants\" }"
         },
         ...

      },
      "borough_1_address.zipcode_1" : {
         "metadata" : {
            "formatVersion" : 8,
            "infoObj" : "{ \"v\" : 2, \"key\" : { \"borough\" : 1, \"address.zipcode\" : 1 }, \"name\" : \"borough_1_address.zipcode_1\", \"ns\" : \"test.restaurants\" }"
         },
         ...
      }
   },
   "indexBuilds" : [ ],  // Available starting in MongoDB 4.2
   "totalIndexSize" : 684032,
   "indexSizes" : {
      "_id_" : 237568,
      "cuisine_1" : 143360,
      "borough_1_cuisine_1" : 151552,
      "borough_1_address.zipcode_1" : 151552
   },
   "scaleFactor" : 1,    // Available starting in MongoDB 4.2
   "ok" : 1
}

统计查询用过滤索引详细¶

要过滤indexDetails字段中的索引，可以使用indexDetailsKey选项指定索引键，也可以使用来指定索引名称indexDetailsName。要发现集合的索引键和名称，请使用db.collection.getIndexes()。

给定以下索引：

复制

{
   "ns" : "test.restaurants",
   "v" : 1,
   "key" : {
      "borough" : 1,
      "cuisine" : 1
   },
   "name" : "borough_1_cuisine_1"
}

以下操作将indexDetails文档筛选为文档定义的单个索引indexDetailsKey。

复制