/ /

InconsistentShardCatalogCollectionMetadata

Description

InconsistentShardCatalogCollectionMetadata: Collection metadata for a sharded collection differs between the config server and the shard catalog.
New in version 9.0. :

Format

{
   type: "InconsistentShardCatalogCollectionMetadata",
   description: "<string>",
   details: {
      namespace: "<string>",
      collectionUUID: <UUID>,
      details: <document>
   }
}

ZonesRangeOverlap inconsistency documents contain the following fields:

Field	Type	Description
`type`	string	Type of inconsistency document. Returns a value of `InconsistentShardCatalogCollectionMetadata` for this inconsistency type.
`description`	string	Describes the inconsistency found in the metadata.
`details`	document	Document with additional information on where the inconsistency exists in the database and sharded cluster.
`details.namespace`	string	Indicates the database and collection where the inconsistency exists.
`details.collectionUUID`	UUID	UUID of the collection.
`details.details`	document	Document that describes the fields that differ between the config server and the shard catalog.

Example

Use the db.adminCommand() method to call the checkMetadataConsistency command:

db.adminCommand( { checkMetadataConsistency: 1 } )

The method returns a cursor with a batch of documents showing the inconsistencies found in the sharding metadata. The example below shows a cursor with a ZonesRangeOverlap inconsistency document:

{
   cursor: {
      id: Long("0"),
      ns: "admin.$cmd.aggregate",
      firstBatch: [
         {
            type: "InconsistentShardCatalogCollectionMetadata",
            description: "Found inconsistencies between collection metadata in the global catalog and the shard catalog",
            details: {
               namespace: "test.authors",
               collectionUUID: UUID("2153613e-f166-437b-99b1-b8711d1cc4ac"),
               details: {
                  field: "shardCatalogEntry",
                  source: "inMemoryShardCatalog",
                  shardCatalog: {
                     _id: "test.authors",
                     lastmodEpoch: ObjectId("6a5a079ca93d70776b2e715c"),
                     timestamp: Timestamp({ t: 1784285084, i: 36 }),
                     uuid: UUID("baeb3cb1-d16f-4b8f-8342-544e52e56d9c"),
                     key: { author: 1 },
                     unique: false,
                     lastmod: ISODate("2026-07-17T10:44:52.275Z")
                  },
                  globalCatalog: {
                     _id: "test.authors",
                     lastmodEpoch: ObjectId("6a5a079ca93d70776b2e715c"),
                     timestamp: Timestamp({ t: 1784285084, i: 36 }),
                     uuid: UUID("2153613e-f166-437b-99b1-b8711d1cc4ac"),
                     key: { author: 1 },
                     unique: false,
                     lastmod: ISODate("2026-07-17T10:44:44.396Z")
                  }
               }
            }
         }
      ],
   },
   ok: 1
}

Back

InconsistentIndex

LegacyShardCacheCollectionsPresent