validate（数据库命令）

定义

validate

validate命令检查集合的数据和索引的正确性并返回结果。该命令还会修复集合的计数和数据大小方面的任何不一致。

提示

在mongosh 中，该命令也可以通过validate() 辅助方法运行。

助手方法对于mongosh 用户来说很方便，但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段，请使用数据库命令。

在版本5.0中进行了更改。

从版本5.0 开始，validate 命令还可以查找集合中的不一致之处，并在可能的情况下进行修复。

索引不一致包括：

• 索引是多键的，但没有多键字段。

• 索引具有多键路径，涵盖非多键字段。

• 索引没有多键路径，但有多键文档（适用于 3.4 之前构建的索引）。

如果 db.collection.validate() 命令检测到任何不一致，将返回警告，然后将索引上的修复标志设置为 true。

db.collection.validate() 还会验证任何违反集合模式验证规则的文档。

注意

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

db.collection.validate()中的 方法提供了mongosh validate的包装器。

兼容性

此命令可用于以下环境中托管的部署：

• MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

• MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

• MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

该命令具有以下语法：

db.runCommand(
   {
     validate: <string>,  // Collection name
     full: <boolean>,  // Optional
     repair: <boolean>,  // Optional, added in MongoDB 5.0
     metadata: <boolean>,  // Optional, added in MongoDB 5.0.4
     checkBSONConformance: <boolean>  // Optional, added in MongoDB 6.2
     background: <boolean> // Optional
   }
)

命令字段

该命令接受以下字段：

db.runCommand( { collMod: <collectionName> } )

行为

示例

• 要使用默认验证设置（特别是 full: false）验证集合 myCollection：

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

• 要对集合 myCollection 执行全面验证，请指定 full: true：

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

• 要修复集合 myCollection，请指定 repair: true：

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

• 要验证 myCollection 集合中的元数据，请指定 metadata: true：

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

• 要在 myCollection 中执行额外的 BSON 一致性检查，请指定 checkBSONConformance: true：

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

验证输出

指定 full：true 以获得更详细的输出。

validate.uuid

集合的通用唯一标识符 (UUID)。

6.2版本新增。

validate.nInvalidDocuments

集合中无效文档的数量。无效文档是指无法读取的文档，这意味着BSON文档已损坏，存在错误或大小不匹配。

validate.nNonCompliantDocuments

不符合集合模式的文档数量。不合规的文档在nInvalidDocuments 中不计为无效。

从 MongoDB 6.2 开始，nNonCompliantDocuments 还包括不符合 BSON 或时间序列集合要求的文档数量。

validate.nrecords

集合中文档数量。

validate.nIndexes

集合上已验证的索引数量。

validate.keysPerIndex

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

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

keysPerIndex 仅通过名称标识索引。

validate.indexDetails

在版本8.1中进行了更改。

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

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

• indexDetails 标识无效的一个或多个特定索引。如果任何索引无效，MongoDB 的早期版本会将所有索引标记为无效。

• indexDetails仅通过名称索引索引。早期版本的MongoDB显示索引的完整命名空间；即<db>.<collection>.$<index_name> 。

• spec文档是索引规范，它因索引的定义方式而异。一些示例spec文档字段包括：

  • spec.v。索引版本。

  • spec.unique。一个布尔值，表示索引是否唯一。

  • spec.key。索引键标识符。

  • spec.name。索引名称。

  8.1版本新增。

validate.ns

集合的完整命名空间名称。命名空间包括格式为 database.collection 的数据库名称和集合名称。

validate.valid

true如果validate 确定集合的所有方面都有效，则为 的布尔值。当false 时，请参阅errors 字段以了解更多信息。

validate.repaired

true如果validate 修复了集合，则为 的布尔值。

validate.repairMode

8.2版本新增。

一个字符串，表示 validate 命令尝试修复的数据不一致类型（如果检测到）。 可能的 repairMode 值包括：

• None：不执行任何修复操作。

• FixErrors：尝试修复任何验证错误。

• AdjustMultikey：尝试通过调整多键元元数据来修复多键不一致问题。

validate.warnings

一个数组，包含有关验证操作本身的警告消息（如有）。警告消息并不表示集合本身无效。例如：

"warnings" : [
   "Could not complete validation of table:collection-28-6471619540207520785. This is a transient issue as the collection was actively in use by other operations."
],

validate.errors

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

validate.extraIndexEntries

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

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

注意

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

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 字段大小的总和限制为1 MB，其中字段大小包括idKey 和indexKey 。如果总和超过此大小，则警告字段会显示一条消息。

validate.corruptRecords

一个由 RecordId 值组成的数组，表示无法读取的文档，可能是因为数据已损坏。这些文档在验证期间被报告为已损坏。RecordId 是一个 64 位整数内部密钥，用于唯一标识集合中的文档。

"corruptRecords" : [
   Long(1),  // RecordId 1
   Long(2)   // RecordId 2
]

版本 5.0 中的新增功能。

validate.ok

1命令成功时值为ok 的整数。如果命令失败，则 字段的值为0 。

validate.fastCountType

用于报告集合大小和数量的元数据集合类型的字符串。可能的 fastCountType 值包括：

• legacySizeStorer

• replicated

• both

• neither