Database Manual / Sharding / Reference / Inconsistency Types

RoutingTableRangeOverlap

Description

RoutingTableRangeOverlap

The routing table of a collection contains two chunks with overlapping shard key ranges.

New in version 7.0.

Format

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

RoutingTableRangeOverlap inconsistency documents contain the following fields:

FieldTypeDescription

type

string

Type of inconsistency document. Returns a value of RoutingTableRangeOverlap 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.chunkA

document

The first chunk that overlaps with the second chunk.

details.chunkB

document

The second chunk that overlaps 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 RoutingTableRangeOverlap inconsistency document:

{
   cursor: {
      id: Long("0"),
      ns: "test.$cmd.aggregate",
      firstBatch: [
         {
            type: "RoutingTableRangeOverlap",
            description: "Found two overlapping 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
}