Índice de queda de pesquisa
Definição
Novidade na versão 7.0: (Disponível também a partir de 6.0.7)
Exclui um índice existentedo Atlas Search.
O mongosh
método db.collection.dropSearchIndex()
fornece um wrapper para o updateSearchIndex
comando de banco de dados de dados .
Importante
Esse comando só pode ser executado em uma implantação hospedada no MongoDB Atlas e não é suportado em instâncias sem servidor.
Sintaxe
Sintaxe do comando:
db.runCommand( { dropSearchIndex: "<collection name>", id: "<index Id>", name: "<index name>" } )
Campos de comando
O comando dropSearchIndex
usa os seguintes campos:
Campo | Tipo | necessidade | Descrição |
---|---|---|---|
dropSearchIndex | string | Obrigatório | Nome da collection que contém o índice a ser excluído. |
id | string | Condicional |
Você deve especificar o campo |
name | string | Condicional | Nome do índice a ser excluído. Você deve especificar o campo |
Comportamento
Após executar o comando dropSearchIndex
, pode haver um atraso entre o momento em que você recebe uma resposta do comando e o momento em que 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 impor o controle de acesso, o usuário executando o comando dropSearchIndex
deverá ter a ação de privilégio do dropSearchIndex
no reconhecimento de data center ou collection:
{ resource: { db : <database>, collection: <collection> }, 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" } ] )
Saída
Um comando dropSearchIndex
bem-sucedido retorna o seguinte:
{ ok: 1 }
Exemplo
O exemplo seguinte exclui um índice de pesquisa denominado searchIndex01
na collection contacts
:
db.runCommand( { dropSearchIndex: "contacts", name: "searchIndex01" } )