Definição
Novidade na versão 7.0: (Também disponível a partir da versão 6.0.7)
Exclui um índice de Pesquisa do Atlas existente.
O mongosh método fornece um wrapper em torno db.collection.dropSearchIndex() do updateSearchIndex reconhecimento de data center .
Importante
Esse comando só pode ser executado em uma implantação hospedada no MongoDB Atlas e requer uma camada do cluster Atlas de pelo menos M10.
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 |
|---|---|---|---|
| string | Obrigatório | Nome da collection que contém o índice a ser excluído. |
| string | Condicional |
Você deve especificar o campo |
| 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"} )