/ /

Comandos de base de datos

Administración

Docs Home

Manual de MongoDB

Referencia

Comandos de base de datos

Administración

dropIndexes

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

dropIndexes: Modificado en la versión 5.0.
El comando elimina uno o más índices (excepto el índice en dropIndexes el _id campo y el último índice de clave de fragmento restante, si existe uno) de la colección especificada.
Tip
mongoshEn, este comando también se puede ejecutar a través del db.collection.dropIndex() db.collection.dropIndexes() Métodos auxiliares y.
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.

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:

{ dropIndexes: <string>, index: <string|document|arrayofstrings>, writeConcern: <document>, comment: <any> }

Campos de comandos

El comando toma los siguientes campos:

Campo	Tipo	Descripción
dropIndexes	String	El nombre de la colección cuyos índices se eliminarán.
index	cadena o documento o matriz de cadenas	El índice o índices a eliminar. Para descartar todos los índices excepto el índice `_id` y el último índice de la clave de partición que queda de la colección si existe, especifica `"*"`. Para eliminar un solo índice, especifique el nombre del índice, el documento de especificación del índice (a menos que sea un índice de texto) o una matriz con el nombre del índice. Para eliminar un índice de texto, especifique los nombres de los índices en lugar del documento de especificación del índice. Si este índice es el último índice de clave de fragmento restante, `dropIndexes` genera un error. Para eliminar varios índices, especifique una matriz con los nombres de los índices.
writeConcern	Documento	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`	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

A partir de MongoDB,5.0 dropIndexes genera un error si se intenta usarlo para eliminar el último índice compatible con la clave de fragmento restante. Al pasar "*" a dropIndexes se eliminan todos los índices excepto el _id índice y el último índice compatible con la clave de fragmento restante, si existe.

Eliminar únicamente las consultas relacionadas

La operación solo elimina las consultas que utilizan el índice que se va a eliminar. Esto puede incluir consultas que consideran el índice como parte de la dropIndexes planificaciónde consultas.

Bloqueo de recursos

dropIndexes obtiene un bloqueo exclusivo en la colección especificada por el tiempo que dure la operación. Todas las operaciones posteriores en la colección deben esperar hasta que dropIndexes libere el bloqueo.

Nombres de índices

Si se pasa al método una matriz de nombres de índice que incluye un índice inexistente, el método genera un error sin eliminar ninguno de los índices especificados.

`_id` Index

No se puede descartar el índice por defecto en el campo _id.

text Indexes

Para eliminar un índice de texto, especifique el nombre del índice en lugar del documento de especificación del índice.

Anular compilaciones de índices en curso

Novedades 4.4 de la versión: Si un índice especificado en dropIndexes aún se está compilando, intenta anular la compilación en curso. Anular la compilación de un índice tiene el mismo efecto que descartar eldropIndexes índice compilado. Antes de MongoDB,4.4 dropIndexes devolvía un error si la colección tenía compilaciones de índice en curso.

Para conjuntos de réplicas, ejecuta dropIndexes en el principal. El primario aborta la creación del índice y crea una entrada "abortIndexBuild" asociada en el registro oplog. Los nodos secundarios que replican la entrada "abortIndexBuild" en el oplog abortan la creación del índice que estaba en curso y descartan la tarea de creación. Consulta Proceso de creación de índices para obtener documentación detallada sobre el proceso de creación de índices y los momentos específicos para terminar una creación de índices en curso.

Los índices especificados en dropIndexes deben ser el conjunto completo de compilaciones en curso asociados a una sola operación de createIndexes o db.collection.createIndexes(). Para descartar un índice específico de un conjunto de compilaciones en curso relacionadas, espera a que se completen las creación de índices y especifica ese índice en dropIndexes.

Por ejemplo, una createIndexes operación / crea tres índices. Suponiendo que las createIndexes() dropIndexes tres compilaciones de índices están en curso, debe especificar los tres índices para cancelarlas.

Utilice para identificar las compilaciones currentOp de índice asociadas a una operación /.createIndexes() Consulte Operaciones de createIndexes indexación activas para ver un ejemplo.

Hidden Indexes

MongoDB ofrece la capacidad de ocultar o mostrar los índices del planificador de las query. Al ocultar un índice del planificador, puedes evaluar el impacto potencial de eliminar un índice sin realmente eliminarlo.

Si después de la evaluación, el usuario decide descartar el índice, puedes descartar el índice oculto; es decir, no es necesario mostrarlo primero para descartarlo.

Sin embargo, si el impacto es negativo, el usuario puede mostrar el índice en lugar de tener que volver a crear un índice descartado. Y como los índices se mantienen en su totalidad mientras están ocultos, están disponibles de inmediato para su uso una vez que se desocultan.

Para obtener más información sobre los índices ocultos, se puede consultar Índices ocultos.

Ejemplos

Para descartar todos los índices que no sean_id, especifica "*" para el index.
```
db.runCommand( { dropIndexes: "collection", index: "*" } )
```
Para eliminar un solo índice, ejecute el comando especificando el nombre del índice que desea eliminar. Por ejemplo, para eliminar el índice age_1, utilice el siguiente comando:
```
db.runCommand( { dropIndexes: "collection", index: "age_1" })
```
mongosh proporciona los métodos auxiliares db.collection.dropIndex() db.collection.dropIndexes()y:
```
db.collection.dropIndex("age_1");
```
Para eliminar varios índices, ejecute el comando especificando una matriz de nombres de índices:
```
db.runCommand( { dropIndexes: "collection", index: [ "age_1", "age_1_status_1" ] } )
```

Tip

Volver

dropConnections

filemd5

Tip