sh.moveChunk()

On this page

Definition

  • sh. moveChunk ( namespace , query , destination )
    • Moves the chunk that contains the document specified by the query to the destination shard. sh.moveChunk() provides a wrapper around the moveChunk database command and takes the following arguments:
ParameterTypeDescription
namespacestringThe namespace of the sharded collection that contains the chunk to migrate.
querydocumentAn equality match on the shard key that selects the chunk to move.
destinationstringThe name of the shard to move.

Important

In most circumstances, allow the balancer to automatically migrate chunks, and avoid calling sh.moveChunk() directly.

Example

Given the people collection in the records database, the following operation finds the chunk that contains the documents with the zipcode field set to 53187 and then moves that chunk to the shard named shard0019 :

sh.moveChunk("records.people", { zipcode: "53187" }, "shard0019")