cleanupOrphaned (comando de base de datos)

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 6.0, consulta el Procedimientos de actualización de MongoDB.7.0

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, emite cleanupOrphaned en la base de datos admin directamente en la instancia mongod que es el miembro primario del set de réplicas de la partición. No necesita deshabilitar el balanceador 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