cloneCollectionAsCapped (comando de base de datos)

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

Definición

cloneCollectionAsCapped: El comando crea un cloneCollectionAsCapped nuevo Colección limitada de una colección existente sin límite dentro de la misma base de datos. La operación no afecta a la colección original sin límite.

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(
   {
     cloneCollectionAsCapped: <existing collection>,
     toCollection: <capped collection>,
     size: <capped size>,
     writeConcern: <document>,
     comment: <any>
   }
)

Campos de comandos

El comando toma los siguientes campos:

Campo	Descripción
cloneCollectionAsCapped	El nombre de la colección existente que se va a copiar.
a la colección	El nombre de la nueva colección limitada que se va a crear. El nombre de la nueva colección limitada debe ser distinto y no puede ser el mismo que el de la colección original existente.
tamaño	El tamaño máximo, en bytes, para la colección limitada.
writeConcern	Opcional. Un documento que expresa el nivel de confirmación de escritura del comando `drop`. Se puede omitir usar el nivel de confirmación de escritura por defecto.
`comment`	Opcional. Un comentario proporcionado por el usuario para adjuntar a este comando. Una vez configurado, este comentario aparece junto a los registros de este comando en las siguientes ubicaciones: Mensajes de registro de mongod, en el campo `attr.command.cursor.comment`. Salida del perfilador de base de datos, en el campo `command.comment`. `currentOp` de salida, en el campo `command.comment`. Un comentario puede ser de cualquier tipo BSON válido (string, objeto, arreglo, etc.).

El comando copia un existing collection y crea un nuevo capped collection con un tamaño máximo especificado por capped size en bytes.

Para reemplazar la colección original sin límite con una colección con límite, utilice el convertToCapped comando.

Comportamiento

Si capped size es menor que el tamaño de la colección de origen, entonces no todos los documentos de la colección de origen existirán en la colección limitada de destino.

Esto mantiene un bloqueo exclusivo de la base de datos durante la operación. Otras operaciones que bloqueen la misma base de datos se bloquearán hasta que la operación se complete. Consulte ¿Qué bloqueos aplican algunas operaciones comunes de cliente? para obtener información sobre las operaciones que bloquean la base de datos.

Volver

Administración

collMod