验证

定义¶

validate¶

该validate命令检查集合的数据并为索引建立正确性并返回结果。

注意

该validate命令不支持视图，并且针对视图运行时会引发错误。

该命令具有以下语法：

复制

db.runCommand( {
   validate: <string>,          // Collection name
   full: <boolean>             // Optional
} )

该命令包含以下字段：

领域	类型	描述
validate	串	要验证的集合的名称。
full	布尔值	可选的。一个标志，用于确定命令执行的是较慢但更彻底的检查还是较快但较不彻底的检查。 如果为true，则执行更彻底的检查。 如果为false，则省略一些检查，以进行更详尽但较不彻底的检查。 默认值为false。 从MongoDB 3.6开始，对于WiredTiger存储引擎，只有 full验证过程才会强制执行检查点并将所有内存中数据刷新到磁盘，然后再验证磁盘上的数据。 在以前的版本中，WT存储引擎的数据验证过程始终强制执行检查点。

该mongo外壳还提供了一个包装器 db.collection.validate()：

复制

db.collection.validate();

行为¶

该validate命令可能很慢，尤其是在较大的数据集上。

该validate命令W在集合上获得排他锁。这将阻止对集合的所有读取和写入，直到操作完成。在辅助服务器上运行时，该 validate操作可以阻止该辅助服务器上的所有其他操作，直到完成为止。

例子¶

• myCollection使用默认设置（即）验证集合full: false

  复制

  db.runCommand( { validate: "myCollection" } )
  

• 执行收集的完整验证 myCollection

  复制

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

验证输出¶

指定以获得更详细的输出。{ full: true }

validate.ns¶

集合的完整名称空间名称。命名空间包括表单中的数据库名称和集合名称 database.collection。

validate.nInvalidDocuments¶

集合中无效文件的数量。

validate.nrecords¶

集合中的文档数。

validate.nIndexes¶

集合上的索引数。

validate.keysPerIndex¶

包含集合中每个索引的名称和索引条目计数的文档。

"keysPerIndex" : {
   "_id_" : <num>,
   "<index2_name>" : <num>,
   ...
}

从MongoDB 4.2（以及4.0.10+和3.6.13+）开始， keysPerIndex仅通过索引名称标识索引。MongoDB的早期版本显示索引的完整名称空间。即<db>.<collection>.$<index_name>

validate.indexDetails¶

包含每个索引的索引验证状态的文档。

"indexDetails" : {
   "_id_" : {
      "valid" : <boolean>
   },
   "<index2_name>" : {
      "valid" : <boolean>
   },
   ...
}

从MongoDB 4.2（以及4.0.10+和3.6.13+）开始，

• indexDetails标识无效的特定索引。如果任何索引无效，则早期版本的MongoDB会将所有索引标记为无效。
• indexDetails仅通过索引名称标识索引。MongoDB的早期版本显示索引的完整名称空间。即<db>.<collection>.$<index_name>。

validate.valid¶

一个布尔值，即trueif，validate确定集合的所有方面都是有效的。如果为false，请参阅该 errors字段以获取更多信息。

validate.errors¶

如果收集无效（即为 valid假），则此字段将包含描述验证错误的消息。

validate.extraIndexEntries¶

一个数组，其中包含指向指向集合中不存在的文档的每个索引条目的信息。

"extraIndexEntries" : [
   {
      "indexName" : <string>,
      "recordId" : <NumberLong>,  // for the non-existent document
      "indexKey" : {
         "<key1>" : <value>,
         ...
      }
   }
   ...
]

注意

对于extraIndexEntries数组，所有indexKey字段大小的总和限制为1MB，其中大小包括键和的值indexKey。如果总和超过此大小，警告字段将显示一条消息。

从MongoDB 4.2（以及4.0.10+和3.6.13+）开始可用

validate.missingIndexEntries¶

一个数组，其中包含缺少相应索引条目的每个文档的信息。

"missingIndexEntries" : [
   {
      "indexName" : <string>,
      "recordId" : <NumberLong>,
      "idKey" : <_id key value>,     // The _id value of the document. Only present if an ``_id`` index exists.
      "indexKey" : {                 // The missing index entry
         "<key1>" : <value>,
         ...
      }
   }
   ...
 ]

注意

对于missingIndexEntries阵列，所述的总和idKey字段大小和它的所有indexKey字段大小为1MB的限制，其中所述场尺寸包括既为键和值idKey和indexKey。如果总和超过此大小，警告字段将显示一条消息。

从MongoDB 4.2（以及4.0.10+和3.6.13+）开始可用

validate.ok¶

1命令执行成功后带有值的整数。如果命令失败，则该ok字段的值为0。