unshardCollection (comando de base de datos)

Definición

unshardCollection

Desharda una colección particionada existente y traslada los datos de la colección a una única partición. Cuando se desagrupa una colección, la colección no puede dividirse entre múltiples shards y la clave de partición se eliminan.

Nuevo en la versión 8.0.

Tip

En mongosh, este comando también se puede ejecutar a través sh.unshardCollection() de.

Los métodos asistente son convenientes para usuarios de mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.

Este comando debe ejecutarse en la base de datos admin.

Si la colección tiene una configuración de zona aplicada, primero debes remover las asociaciones de rango y las particiones de la zona antes de dividir la colección. Para obtener más información, consulta Zonas sin particiones.

Nota

Desfragmentar una colección es una operación intensiva en escritura que puede resultar en una mayor tasa de crecimiento del oplog. Para ayudar a mitigar esto, considera los siguientes cambios de configuración:

• Para prevenir el crecimiento ilimitado del oplog, establece un tamaño fijo para el oplog.

• Para reducir la posibilidad de que los secundarios queden obsoletos, aumente el tamaño del oplog.

Para obtener más detalles, consulta el Oplog del set de réplicas.

Compatibilidad

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

• 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.

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

Restricciones

No se puede utilizar unshardCollection para colecciones de cifrado consultable.

Sintaxis

db.adminCommand( {
   unshardCollection: "<database>.<collection>",
   toShard: "<shard-id>"
} )

Campos de comandos

Considerations

• unshardCollection Sólo se puede ejecutar en clústeres fragmentados.

• unshardCollection solo puede operar en colecciones fragmentadas.

• unshardCollection solo puede operar en una única colección a la vez.

• unshardCollection tiene una duración mínima de 5 minutos.

• Debe reconstruir los índices de búsqueda de Atlas después de que se ejecute unshardCollection.

• No puede realizar cambios de topología, como añadir o remover particiones o pasar de servidores de configuración dedicados a embebidos, hasta que unshardCollection se complete.

• No puedes ejecutar las siguientes operaciones en la colección que se está desfragmentando mientras unshardCollection está en curso:

  • collMod

  • convertToCapped

  • createIndexes

  • db.collection.createIndexes()

  • drop

  • db.collection.drop()

  • dropIndexes

  • db.collection.dropIndex()

  • renameCollection

  • db.collection.renameCollection()

• No se pueden ejecutar las siguientes operaciones en el clúster mientras unshardCollection esté en progreso:

  • addShard

  • removeShard

  • db.createCollection()

  • dropDatabase

  • transitionToDedicatedConfigServer

  • transitionFromDedicatedConfigServer

• Las creaciones de índices que ocurran mientras unshardCollection esté en curso podrían fallar silenciosamente.

  • No cree índices mientras unshardCollection esté en progreso.

  • No llame a unshardCollection si hay creaciones de índices en curso.

Requisitos

Antes de desfragmentar tu colección, asegúrate de cumplir los siguientes requisitos:

• Su aplicación puede tolerar un periodo de dos segundos en el que la colección afectada bloquea las escrituras. Durante este periodo, la aplicación experimenta un aumento de latencia.

• Su base de datos cumple con estos requisitos de recursos:

  • Asegúrate de que la partición a la que mueves la colección tenga suficiente espacio de almacenamiento para la colección y sus índices. La partición de destino requiere al menos ( Collection storage size + Index Size ) * 2 bytes disponibles.

  • Asegúrate de que tu capacidad de E/S esté por debajo de 50%.

  • Asegúrate de que la carga de tu CPU esté por debajo del 80%.

Comportamiento

Ejemplos

db.adminCommand( {
    unshardCollection: "sales.eu_accounts"
} )

db.adminCommand( {
    unshardCollection: "sales.eu_accounts",
    toShard: "shard1"
} )

db.adminCommand( { balancerStop: 1 } )

sh.status()

db.adminCommand( {
   updateZoneKeyRange: "app.inventory",
   min: 100,
   max: 500,
   zone: null
} )

db.adminCommand( {
   removeShardFromZone: "shard01",
   zone: "us"
} )

db.adminCommand( { balancerStart: 1 } )

db.adminCommand( { unshardCollection: "app.inventory" } )

Obtén más información

• sh.unshardCollection()

• Eliminar partición de una colección