dropSearchIndex (comando de base de datos)

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 6.0, consulta el Procedimientos de actualización de MongoDB.7.0

Definición

dropSearchIndex

Novedades en la versión 6.0.7.

Borra un Atlas índice de búsqueda existente.

El método mongosh db.collection.dropSearchIndex() proporciona un contenedor alrededor del comando de base de datos updateSearchIndex.

Importante

Este comando solo se puede ejecutar en una implementación alojada en MongoDB Atlas y requiere un nivel de clúster de Atlas de al menos M10.

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
`dropSearchIndex`	string	Requerido	Nombre de la colección que contiene el índice que se borrará.
`id`	string	Condicional	`id` del índice que se va a borrar. Debes especificar ya sea el campo `id` o `name`.
`name`	string	Condicional	Nombre del índice a borrar. Debes especificar ya sea el campo `id` o `name`.

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 dbAdmin integrados y readWrite otorgan el dropSearchIndex privilegio. El siguiente ejemplo otorga el readWrite rol en la qa base de datos:

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"
} )

Volver

crear índices de búsqueda

updateSearchIndex