/ /

Comandos de base de datos

Administración

Docs Home

Manual de base de datos

Referencia

Comandos de base de datos

Administración

renameCollection (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

renameCollection

Cambia el nombre de una colección existente. Especifique los nombres de colección como renameCollection en forma de un archivo completo. espacio de nombres ().<database>.<collection>

Tip

mongoshEn, este comando también se puede ejecutar a través del método renameCollection() auxiliar.

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.

Emita el comando contra renameCollection la base de datos de administración.

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

Nota

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte 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(
   {
     renameCollection: "<source_namespace>",
     to: "<target_namespace>",
     dropTarget: <true|false>,
     writeConcern: <document>,
     comment: <any>
   }
)

Campos de comandos

El comando contiene los siguientes campos:

Campo	Tipo	Descripción
`renameCollection`	string	El espacio de nombres de la colección que se va a renombrar. Este espacio de nombres es una combinación del nombre de la base de datos y el nombre de la colección.
`to`	string	El nuevo espacio de nombres de la colección. Si el nuevo espacio de nombres especifica una base de datos diferente, el `renameCollection` comando copia la colección a la nueva base de datos y elimina la colección de origen. Consulte Restricciones de nombres.
`dropTarget`	booleano	Opcional. Si `true` es, eliminará`mongod` el `target` de antes de renombrar la colección. El valor `renameCollection` predeterminado `false` es.
`writeConcern`	Documento	Opcional. Un documento que expresa el nivel de confirmación de escritura para la operación. Omite usar el nivel de confirmación de escritura por defecto. Cuando se emite en un clúster particionado, `mongos` convierte el nivel de confirmación de escritura del comando `renameCollection` y su asistente `db.collection.renameCollection()` a `"majority"`.
`comment`	any	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.).

Comportamiento

Colecciones fragmentadas

A partir de MongoDB 5.0, se puede usar el comando renameCollection para cambiar el nombre de una colección particionada. La base de datos destino debe ser la misma que la base de datos de origen.

Colecciones no particionadas

Se puede usar renameCollection para renombrar una colección no particionada en un clúster siempre que las bases de datos de origen y destino estén en la misma partición primaria.

Colecciones de series de tiempo

No puedes utilizar renameCollection para renombrar una colección de series de tiempo. Para obtener más información, consulta Limitaciones de la colección de series de tiempo.

Colección de objetivos existentes

renameCollection falla si target es el nombre de una colección existente y no dropTarget: true especifica.

Rendimiento

Cambiado en la versión 3.6.

renameCollection tiene diferentes implicaciones de rendimiento según el espacio de nombres de destino.

Si la base de datos de destino es la misma que la de origen, simplemente cambia el espacio de nombres. Esta operación esrenameCollection rápida.

Si la base de datos de destino es diferente de la de origen, copia todos los documentos de la colección de origen a la de destino. Dependiendo del tamaño de la colección, este proceso puede tardarrenameCollection más.

Bloqueo de recursos en clústeres fragmentados

Modificado en la versión 5.0.

Al cambiar el nombre de una colección particionada o no particionada en un clúster, las colecciones de origen y destino se bloquean exclusivamente en cada partición. Las operaciones posteriores en las colecciones de origen y destino deben esperar hasta que se complete la operación de cambio de nombre.

Para obtener más información sobre el bloqueo en MongoDB, consulte Preguntas frecuentes: Concurrencia.

Bloqueo de recursos en conjuntos de réplicas

Si se renombra una colección dentro de la misma base de datos, obtiene un bloqueo exclusivo en las colecciones de origen y destino duranterenameCollection renameCollection la operación. Todas las operaciones posteriores en las colecciones deben esperar hasta que se complete.

Al renombrar una colección entre diferentes bases de datos, obtiene un bloqueo exclusivo (W) en la base de datos de destino, un bloqueo compartido (r) por intención en la base de datos derenameCollection renameCollection origen y un bloqueo compartido (S) en la colección de origen. Las operaciones posteriores en la base de datos de destino deben esperar hasta que libere el bloqueo exclusivo de la base de datos.

Para obtener más información sobre el bloqueo en MongoDB, consulte Preguntas frecuentes: Concurrencia.

`local` Database

No se puede cambiar el nombre de una colección de una base de datos replicada a la base de datos local, que no está replicada.
No se puede cambiar el nombre de una colección de la base de datos local, que no está replicada, a una base de datos replicada.

Cursores abiertos

Advertencia

El db.collection.renameCollection() método y renameCollection el comando invalidarán los cursores abiertos que interrumpen las consultas que actualmente están devolviendo datos.

Flujos de cambio

Para los flujos de cambio, el db.collection.renameCollection() método y renameCollection el comando crean un evento de invalidación para cualquier flujo de cambio existente abierto en la colección de origen o de destino.

Interacción con `mongodump`

Unmongodumpiniciado con--oplogfalla si un cliente ejecuta el comandorenameCollectiondurante el proceso de volcado. Consultemongodump.--oplogpara obtener más información.

Ejemplo

El siguiente ejemplo renombra una colección llamada orders en la base de datos test a orders2014 en la base de datos test.

db.adminCommand( { renameCollection: "test.orders", to: "test.orders2014" } )

mongosh proporciona el db.collection.renameCollection() asistente para el comando que permite renombrar colecciones dentro de la misma base de datos. El siguiente ejemplo es equivalente al anterior:

use test
db.orders.renameCollection( "orders2014" )

Volver

reIndex

rotateCertificates