Definición
Novedades en la versión 7.0: (También disponible a partir de la versión 6.0.7)
Borra un índice de búsqueda de MongoDB Search existente.
El método mongosh db.collection.dropSearchIndex() proporciona un contenedor alrededor del comando de base de datos updateSearchIndex.
Nota
Además de MongoDB Atlas, este comando está disponible en las siguientes implementaciones autogestionadas:
MongoDB Enterprise implementaciones que ejecutan la versión 8.2 o posterior con el Operador de Kubernetes
MongoDB Community las implementaciones que ejecutan la versión 8.2 o posteriores
Para obtener más información, consulta MongoDB Search en implementaciones autogestionadas.
Sintaxis
Sintaxis del comando:
db.runCommand( { dropSearchIndex: "<collection name>", id: "<index Id>", name: "<index name>" })Campos de comandos
El comando dropSearchIndex toma los siguientes campos:
Campo | Tipo | Necesidad | Descripción |
|---|---|---|---|
| string | Requerido | Nombre de la colección que contiene el índice que se borrará. |
| string | Condicional |
Debes especificar ya sea el campo |
| string | Condicional | Nombre del índice a borrar. Debes especificar ya sea el campo |
Comportamiento
Después de ejecutar el comando dropSearchIndex, puede que haya una demora entre el momento en que recibe una respuesta del comando y cuando se borra el índice.
Para ver el estado de los índices de búsqueda, utiliza la etapa de agregación $listSearchIndexes. Una vez que se borra el índice, este deja de aparecer en la salida de $listSearchIndexes.
Control de acceso
Si tu implementación aplica un control de acceso, el usuario que ejecute el comando dropSearchIndex debe tener la acción de privilegio dropSearchIndex en la base de datos o colección:
{ resource: { db : <database>, collection: <collection> }, actions: [ "dropSearchIndex" ]}Los roles integrados dbAdmin y readWrite proporcionan el privilegio de dropSearchIndex. El siguiente ejemplo otorga el rol readWrite en la base de datos qa:
db.grantRolesToUser( "<user>", [ { role: "readWrite", db: "qa" } ])Salida
Un comando dropSearchIndex exitoso devuelve lo siguiente:
{ ok: 1}Ejemplo
El siguiente ejemplo elimina un índice de búsqueda llamado searchIndex01 en la colección contacts:
db.runCommand( { dropSearchIndex: "contacts", name: "searchIndex01"} )