mergeChunks (comando de base de datos)

Definición

mergeChunks

Para una colección fragmentada, mergeChunks combina contiguos Los rangos de fragmentos de un fragmento se convierten en un solo fragmento. Ejecute el mergeChunks comando en la admin base de datos desde una mongos instancia.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Sintaxis

El comando tiene la siguiente sintaxis:

db.adminCommand(
   {
     mergeChunks: <namespace>,
     bounds : [
       { <shardKeyField>: <minFieldValue> },
       { <shardKeyField>: <maxFieldValue> }
     ]
   }
)

Para las claves de fragmento compuestas, debe incluir la clave de fragmento completa en la bounds especificación. Por ejemplo, si la clave de fragmento { x: 1, y: 1 } es, tiene el siguientemergeChunks formato:

db.adminCommand(
   {
     mergeChunks: <namespace>,
     bounds: [
       { x: <minValue>, y: <minValue> },
       { x: <maxValue>, y: <maxValue> }
     ]
   }
 )

Campos de comandos

El comando toma los siguientes campos:

Control de acceso

En las implementaciones que se ejecutan con,authorization clusterManager el rol integrado proporciona los privilegios necesarios.

Comportamiento

Para fusionar fragmentos con éxito, se debe cumplir lo siguiente:

• En el bounds campo, <minkey> y <maxkey> deben corresponder a los límites inferior y superior de los fragmentos que se fusionarán.

• Los fragmentos deben residir en el mismo fragmento.

• Los trozos deben ser contiguos.

mergeChunks devuelve un error si no se cumplen estas condiciones.

Mensajes de retorno

En caso de éxito, devuelve estemergeChunks documento:

{
  "ok" : 1,
  "$clusterTime" : {
     "clusterTime" : Timestamp(1510767081, 1),
     "signature" : {
         "hash" : BinData(0,"okKHD0QuzcpbVQg7mP2YFw6lM04="),
         "keyId" : Long("6488693018630029321")
      }
  },
  "operationTime" : Timestamp(1510767081, 1)
}

errmsg: "The collection's metadata lock is already taken."

{
  "ok" : 0,
  "errmsg" : "could not merge chunks, collection test.users does not contain a chunk ending at { username: \"user63169\" }",
  "$clusterTime" : {
     "clusterTime" : Timestamp(1510767081, 1),
     "signature" : {
         "hash" : BinData(0,"okKHD0QuzcpbVQg7mP2YFw6lM04="),
         "keyId" : Long("6488693018630029321")
      }
  },
  "operationTime" : Timestamp(1510767081, 1)
}

{
  "ok" : 0,
  "errmsg" : "could not merge chunks, collection test.users has more than 2 chunks between [{ username: \"user29937\" }, { username: \"user49877\" })"
  "$clusterTime" : {
     "clusterTime" : Timestamp(1510767081, 1),
     "signature" : {
         "hash" : BinData(0,"okKHD0QuzcpbVQg7mP2YFw6lM04="),
         "keyId" : Long("6488693018630029321")
      }
  },
  "operationTime" : Timestamp(1510767081, 1)
}