db.collection.dropSearchIndex()
Definição
Novidade na versão 7.0: (Disponível também a partir de 6.0.7)
Exclui um índice existentedo Atlas Search.
Importante
Método mongosh
Esta página documenta um método mongosh
. Esta não é a documentação para comandos de banco de dados nem drivers específicos de linguagem, como Node.js.
Para o comando de banco de dados de dados, consulte o comando dropSearchIndex
.
Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.
Compatibilidade
Esse método está disponível em implantações hospedadas nos seguintes ambientes:
MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem
Importante
Esse comando não é aceito em clusters M0, M2 e M5 ou em instâncias sem servidor. Para obter mais informações, consulte Comandos não suportados.
Sintaxe
Sintaxe do comando:
db.<collection>.dropSearchIndex(<name>)
Campos de comando
dropSearchIndex()
usa o seguinte campo:
Campo | Tipo | necessidade | Descrição |
---|---|---|---|
| string | Obrigatório | Nome do índice de pesquisa a ser descartado. |
Comportamento
Após executar o dropSearchIndex()
, pode haver um atraso entre o momento em que você recebe uma resposta do comando e quando o índice é excluído.
Para ver o status dos seus índices de pesquisa, use o estágio de agregação $listSearchIndexes
. Depois que seu índice for excluído, esse índice não aparecerá mais na saída $listSearchIndexes
.
Controle de acesso
Se a sua implementação forçar o controle de acesso, o usuário executando o método do dropSearchIndex()
deverá ter a ação de privilégio do dropSearchIndex
no reconhecimento de data center:
{ resource: { database : true }, actions: [ "dropSearchIndex" ] }
Os papéis embutidos dbAdmin
e readWrite
fornecem o privilégio do dropSearchIndex
. O exemplo a seguir concede a role readWrite
no reconhecimento de data center qa
:
db.grantRolesToUser( "<user>", [ { role: "readWrite", db: "qa" } ] )
Exemplo
O exemplo seguinte exclui um índice de pesquisa denominado searchIndex01
na collection movies
:
db.movies.dropSearchIndex("searchIndex01")