db.collection.dropSearchIndex()
定义
7.0 版本中的新增功能:(也可从 6.0.7 开始使用)
删除现有的 Atlas Search 索引。
重要
mongosh 方法
本页面提供 mongosh
方法的相关信息。这不是数据库命令或特定语言驱动程序(例如 Node.js)的相关文档。
有关数据库命令,请参阅 dropSearchIndex
命令。
如需了解 MongoDB API 驱动程序,请参阅特定语言的 MongoDB 驱动程序文档。
兼容性
此方法可用于以下环境中托管的部署:
MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务
重要
M 0 、M 2和 M 5集群或无服务器实例不支持此命令。 有关更多信息,请参阅不支持的命令。
语法
命令语法:
db.<collection>.dropSearchIndex(<name>)
命令字段
dropSearchIndex()
采用以下字段:
字段 | 类型 | 必要性 | 说明 |
---|---|---|---|
name | 字符串 | 必需 | 要删除的搜索索引的名称。 |
行为
运行dropSearchIndex()
后,在收到命令响应和删除索引之间可能存在延迟。
要查看搜索索引的状态,请使用$listSearchIndexes
聚合阶段。 删除索引后,该索引将不再出现在$listSearchIndexes
输出中。
访问控制
如果您的部署强制执行访问控制,则运行dropSearchIndex()
方法的用户必须对数据库具有dropSearchIndex
权限操作:
{ resource: { database : true }, actions: [ "dropSearchIndex" ] }
内置的dbAdmin
和readWrite
角色提供dropSearchIndex
权限。以下示例授予对qa
数据库的readWrite
角色:
db.grantRolesToUser( "<user>", [ { role: "readWrite", db: "qa" } ] )
例子
以下示例删除movies
集合上名为searchIndex01
的搜索索引:
db.movies.dropSearchIndex("searchIndex01")