You are viewing an offline version of MongoDB documentation. Some page features might be unavailable. To view the latest version of the page or use interactive features, visit the live page.

RoutingTableRangeGap

Description

RoutingTableRangeGap: A range gap exists in the routing table between two consecutive chunks for the same collection.
New in version 7.0.

Format

{
   type: "RoutingTableRangeGap",
   description: "<string>",
   details: {
      namespace: "<string>",
      collectionUUID: <string>,
      chunkA: {<document>},
      chunkB: {<document>}
   }
}

RoutingTableRangeGap inconsistency documents contain the following fields:

Field	Type	Description
`type`	string	Type of inconsistency document. Returns a value of `RoutingTableRangeGap` for this inconsistency type.
`description`	string	Describes the nature of 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.chunkA`	document	The first chunk that has a gap with the second chunk.
`details.chunkB`	document	The second chunk that has a gap with the first chunk.

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 RoutingTableRangeGap inconsistency document:

{
   cursor: {
      id: Long("0"),
      ns: "test.$cmd.aggregate",
      firstBatch: [
         {
            type: "RoutingTableRangeGap",
            description: "Found a gap between two consecutive chunks",
            details: {
               namespace: "test.authors",
               collectionUUID: new UUID("62ebdb7e-a7bb-4151-a620-49d44cef097f"),
               chunkA: {
                 _id: ObjectId("64dde749ac6045c92ef3b9ad"),
                 uuid: new UUID("8c83ea89-ab6b-4ae4-91ab-813cf781284d"),
                 min: {
                    x: MinKey
                 },
                 max: {
                    x: 0
                 },
                 shard: "shard0000",
                 lastmod: Timestamp(1, 0),
                 onCurrentShardSince: Timestamp(1, 0),
                  history: [
                     {
                        validAfter: Timestamp(1, 0),
                        shard: "shard0000"
                     }
                  ]
               },
               chunkB: {
                  _id: ObjectId("64dde749ac6045c92ef3b9af"),
                  uuid: new UUID("8c83ea89-ab6b-4ae4-91ab-813cf781284d"),
                  min: {
                     x: 10
                  },
                  max: {
                     x: MaxKey
                  },
                  shard: "shard0000",
                  lastmod: Timestamp(1, 0),
                  onCurrentShardSince: Timestamp(1, 0),
                  history: [
                     {
                        validAfter: Timestamp(1, 0),
                        shard: "shard0000"
                     }
                  ]
               }
            }
         }
      ],
   },
   ok: 1
}

Back

RoutingTableMissingMinKey

RoutingTableRangeOverlap