/ /

particionado

Docs Home

Desarrollo

Comandos de base de datos

particionado

Docs Home

Desarrollo

Comandos de base de datos

particionado

cleanupOrphaned (comando de base de datos)

Importante

A partir de MongoDB 6.0.3, debe ejecutar una agregación utilizando el $shardedDataDistribution etapa para confirmar que no queden documentos huérfanos. Para obtener más información, consulta Confirmar que no queden documentos huérfanos.

Definición

cleanupOrphaned

Usa este comando para esperar a que los documentos huérfanos en un rango de fragmento desde el MinKey de una clave de partición hasta su MaxKey para que se limpien en la mayoría de los nodos de una partición para el namespace especificado.

Para ejecutar, emitir cleanupOrphaned en la base de datos admin directamente en la instancia mongod que es el miembro principal del conjunto de réplicas de la partición. No es necesario desactivar el equilibrador antes de ejecutar cleanupOrphaned.

Nota

No ejecutes cleanupOrphaned en una instancia mongos.

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

Importante

Este comando no es compatible con los clústeres M0 y Flex. Para obtener más información, consulta Comandos no compatibles.

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.runCommand(
   {
     cleanupOrphaned: "<database>.<collection>",
     startingFromKey: <minimumShardKeyValue>, // deprecated
     secondaryThrottle: <boolean>, // deprecated
     writeConcern: <document> // deprecated
   }
)

Campos de comandos

cleanupOrphaned tiene los siguientes campos:

Campo	Tipo	Descripción
`cleanupOrphaned`	string	El namespace, es decir, tanto la base de datos como el nombre de la colección, de la colección particionada para la que se debe esperar la limpieza de los datos huérfanos.

Comportamiento

Determinar rango

El valor de este campo no se utiliza para determinar los límites del rango de limpieza. El comando cleanupOrphaned espera hasta que se limpien de la partición todos los documentos huérfanos en todos los rangos del namespace antes de completarse, independientemente de la presencia o el valor de startingFromKey.

Acceso requerido

En los sistemas que funcionan con authorization, debes tener privilegios de clusterAdmin para ejecutar cleanupOrphaned.

Salida

Return Document

Cada comando cleanupOrphaned devuelve un documento que contiene un subconjunto de los siguientes campos:

cleanupOrphaned.ok

Igual a 1 en caso de éxito.

Un valor de 1 indica que:

No quedan documentos huérfanos en el namespace cleanupOrphaned en la partición, o
La colección referenciada en el namespace cleanupOrphaned no está particionada.

Un valor de 0 indica que ha ocurrido un error.

Volver

clearJumboFlag

cleanupReshardCollection