dropSearchIndex (comando de banco de dados)

Esta versão da documentação foi arquivada e não é mais suportada. Para atualizar seu sistema do 6.0, consulte osprocedimentos de atualização do MongoDB 7.0 .

Definição

dropSearchIndex

Novidade na versão 6.0.7.

Exclui um índice de Pesquisa do Atlas existente.

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 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
`dropSearchIndex`	string	Obrigatório	Nome da collection que contém o índice a ser excluído.
`id`	string	Condicional	`id` do índice a ser excluído. Você deve especificar o campo `id` ou `name` .
`name`	string	Condicional	Nome do índice a ser excluído. Você deve especificar o campo `id` ou `name` .

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

Voltar

Crie índices de pesquisa

Atualizar índice de pesquisa