/ /

Administración

Docs Home

Desarrollo

Comandos de base de datos

Administración

Docs Home

Desarrollo

Comandos de base de datos

Administración

cloneCollectionAsCapped (comando de base de datos)

Definición

cloneCollectionAsCapped: La cloneCollectionAsCapped El comando crea un 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.
toCollection	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 con tamaño fijo.
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 el capped size en bytes.

Para reemplazar la colección original no asignada con una colección con tamaño fijo, use el comando convertToCapped.

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 base de datos durante el período de la operación. Otras operaciones que bloqueen la misma base de datos serán bloqueadas hasta que la operación se complete. Consulta ¿Qué bloqueos toma algunas operaciones comunes del cliente? para operaciones que bloquean la base de datos.

Volver

bulkWrite

collMod