validate

Definition

validate

The validate command checks the structures within a namespace for correctness by scanning the collection’s data and indexes. The command returns information regarding the on-disk representation of the collection.

The validate command can be slow, particularly on larger data sets.

The following example validates the contents of the collection named users.

{ validate: "users" }

You may also specify one of the following options:

  • full: true provides a more thorough scan of the data.

  • scandata: false skips the scan of the base collection

    without skipping the scan of the index.

The mongo shell also provides a wrapper:

db.collection.validate();

Use one of the following forms to perform the full collection validation:

db.collection.validate(true)
db.runCommand( { validate: "collection", full: true } )

警告

This command is resource intensive and may have an impact on the performance of your MongoDB instance.

Output

validate.ns

The full namespace name of the collection. Namespaces include the database name and the collection name in the form database.collection.

validate.firstExtent

The disk location of the first extent in the collection. The value of this field also includes the namespace.

validate.lastExtent

The disk location of the last extent in the collection. The value of this field also includes the namespace.

validate.extentCount

该集合中的片区数量。

validate.extents

validate returns one instance of this document for every extent in the collection. This sub-document is only returned when you specify the full option to the command.

validate.extents.loc

此片区在磁盘上的开始位置。

validate.extents.xnext

The disk location for the extent following this one. “null” if this is the end of the linked list of extents.

validate.extents.xprev

The disk location for the extent preceding this one. “null” if this is the head of the linked list of extents.

validate.extents.nsdiag

The namespace this extent belongs to (should be the same as the namespace shown at the beginning of the validate listing).

validate.extents.size

此片区中的字节数量。

validate.extents.firstRecord

此片区中的第一个记录在磁盘上的位置。

validate.extents.lastRecord

此片区中的最后一个记录在磁盘上的位置。

validate.datasize

The number of bytes in all data records. This value does not include deleted records, nor does it include extent headers, nor record headers, nor space in a file unallocated to any extent. datasize includes record padding.

validate.nrecords

集合中的 文档 数量。

validate.lastExtentSize

The size of the last new extent created in this collection. This value determines the size of the next extent created.

validate.padding

1 到 2 之间的浮点值。

When MongoDB creates a new record it uses the padding factor to determine how much additional space to add to the record. The padding factor is automatically adjusted by mongo when it notices that update operations are triggering record moves.

validate.firstExtentDetails

The size of the first extent created in this collection. This data is similar to the data provided by the extents sub-document; however, the data reflects only the first extent in the collection and is always returned.

validate.firstExtentDetails.loc

此片区在磁盘上的开始位置。

validate.firstExtentDetails.xnext

The disk location for the extent following this one. “null” if this is the end of the linked list of extents, which should only be the case if there is only one extent.

validate.firstExtentDetails.xprev

The disk location for the extent preceding this one. This should always be “null.”

validate.firstExtentDetails.nsdiag

The namespace this extent belongs to (should be the same as the namespace shown at the beginning of the validate listing).

validate.firstExtentDetails.size

此片区中的字节数量。

validate.firstExtentDetails.firstRecord

此片区中的第一个记录在磁盘上的位置。

validate.firstExtentDetails.lastRecord

此片区中的最后一个记录在磁盘上的位置。

validate.objectsFound

The number of records actually encountered in a scan of the collection. This field should have the same value as the nrecords field.

validate.invalidObjects

The number of records containing BSON documents that do not pass a validation check.

注意

This field is only included in the validation output when you specify the full option.

validate.bytesWithHeaders

This is similar to datasize, except that bytesWithHeaders includes the record headers. In version 2.0, record headers are 16 bytes per document.

注意

This field is only included in the validation output when you specify the full option.

validate.bytesWithoutHeaders

bytesWithoutHeaders returns data collected from a scan of all records. The value should be the same as datasize.

注意

This field is only included in the validation output when you specify the full option.

validate.deletedCount

The number of deleted or “free” records in the collection.

validate.deletedSize

The size of all deleted or “free” records in the collection.

validate.nIndexes

集合中的数据的索引数量。

validate.keysPerIndex

A document containing a field for each index, named after the index’s name, that contains the number of keys, or documents referenced, included in the index.

validate.valid

Boolean. true, unless validate determines that an aspect of the collection is not valid. When false, see the errors field for more information.

validate.errors

Typically empty; however, if the collection is not valid (i.e valid is false,) this field will contain a message describing the validation error.

validate.ok

Set to 1 when the command succeeds. If the command fails the ok field has a value of 0.

MongoDB 手册 2.4

格式

关于 MongoDB

MongoDB Ecosystem

MongoDB Resources