Docs 菜单
Docs 主页
/
MongoDB Manual
/ / /

db.collection.checkMetadataConsistency()

在此页面上

  • 定义
  • 兼容性
  • 语法
  • 例子
db.collection.checkMetadataConsistency(options)

对collection的元数据执行一系列一致性检查。该方法返回一个游标,其中包含找到的全部或批处理的不一致结果。

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是数据库命令或特定语言驱动程序(例如 Node.js)的相关文档。

有关数据库命令,请参阅 checkMetadataConsistency 命令。

如需了解 MongoDB API 驱动程序,请参阅特定语言的 MongoDB 驱动程序文档。

在主要维护操作(例如升级和降级)后运行此方法,以检查目录的状态。

默认情况下,该方法不会检查索引在分片之间的一致性。 如果索引检查与创建、删除或修改索引的操作同时运行,则可能会返回不一致的误报。 要使用此方法检查索引,请设置checkIndexes选项。

有关此方法检查不一致的更多信息,请参阅不一致类型。

返回:此方法返回带有documents数组的游标,该数组包含分片元数据中发现的每个不一致的文档。

此方法可用于以下环境中托管的部署:

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

重要

M 0 、M 2和 M 5集群不支持此命令。 有关更多信息,请参阅不支持的命令。

db.collection.checkMetadataConsistency() 方法使用的语法如下:

db.collection.checkMetadataConsistency( { <options> } )

options文档可以采用以下字段和值:

字段
类型
说明
checkIndexes
布尔

设置该命令是否还检查分片元数据中的索引。

默认情况下,此操作处于禁用状态,因为与创建、删除或修改索引的操作并发运行时,它可能会返回不一致的误报。 仅当您知道这些操作不太可能发生时才检查索引。

cursor
文档
配置返回游标。
cursor.batchSize
整型
每个批次中包含的分片元数据不一致文档的最大数量。
db.authors.checkMetadataConsistency()
{
cursorHasMore: false,
documents: [
{
type: "MisplacedCollection",
description: "Unsharded collection found on shard different from database primary shard",
details: {
namespace: "test.authors",
shard: "shard02",
localUUID: new UUID("1ad56770-61e2-48e9-83c6-8ecefe73cfc4")
}
}
],
}

后退

db.checkMetadataConsistency