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