/ /

Comandos de base de datos

Búsqueda de Atlas

Docs Home

Desarrollo

Comandos de base de datos

Búsqueda de Atlas

dropSearchIndex (comando de base de datos)

Definición

dropSearchIndex

Nuevo en la versión 7.0: (También disponible a partir de la versión 6.0.7)

Elimina un(a) existente MongoDB Search índice.

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.

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

Volver

crearÍndicesDeBúsqueda

updateSearchIndex