Docs Menu
Docs Home
/
MongoDB Manual
/
Sharding
/
Sharding Reference
/
Inconsistency Types

RoutingTableMissingMaxKey

On this page

  • Description
  • Format
  • Example

Description

RoutingTableMissingMaxKey

A range gap exists in the routing table. The last chunk boundary in the routing table does not reach the maximum key value.

New in version 7.0.

Format

{
   type: "RoutingTableMissingMaxKey",
   description: "<string>",
   details: {
      namespace: "<string>",
      collectionUUID: <string>,
      maxKeyObj: { <document> },
      globalMax: { <document> }
   }
}

RoutingTableMissingMaxKey inconsistency documents contain the following fields:

Field
Type
Description
type
string

Type of inconsistency document. Returns a value of RoutingTableMissingMaxKey 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.maxKeyObj
document
The max key used by the collection.
details.globalMax
document
The expected max key of the collection.

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

{
   cursor: {
      id: Long("0"),
      ns: "test.$cmd.aggregate",
      firstBatch: [
         {
            type: "RoutingTableMissingMaxKey",
            description: "Routing table has a gap because last chunk boundary does not reach MaxKey",
            details: {
               namespace: "test.authors",
               collectionUUID: new UUID("62ebdb7e-a7bb-4151-a620-49d44cef097f"),
               maxKeyObj: {
                  x: 0
               },
               globalMax: {
                  x: MaxKey
               }
            }
         }
      ],
   },
   ok: 1
}

Back

MissingShardKeyIndex