db.collection.dropIndexes()

Definição

db.collection.dropIndexes()

Importante

Método mongosh

Esta página documenta um método mongosh . Esta não é a documentação para comandos de banco de dados ou drivers específicos de idioma, como Node.js.

Para o comando do banco de dados, consulte o comando dropIndexes.

Para drivers de API do MongoDB, consulte a documentação do driver MongoDB específica do idioma.

Para a documentação de shell legada do mongo, consulte a documentação para a versão correspondente do MongoDB Server:

mongo shell v4.4

Descarta o(s) index(es) especificado(s) (exceto o index no field _id e o último index de chave de estilhaço restante) de uma coleção.

Você pode usar o método para:

• Solte todos, exceto o índice _id de uma coleção.

  db.collection.dropIndexes()

• Solte um índice especificado de uma coleção. Para especificar o índice, você pode passar o método:

  • O documento de especificação do índice (a menos que o índice seja um índice de texto; nesse caso, use o nome do índice para descartar):

    db.collection.dropIndexes( { a: 1, b: 1 } )

  • O nome do índice:

    db.collection.dropIndexes( "a_1_b_1" )

    Dica

    Para obter os nomes dos índices, utilize o método db.collection.getIndexes().

• Descarte os índices especificados de uma coleção. Para especificar vários índices a serem descartados, passe ao método um array de nomes de índices:

  db.collection.dropIndexes( [ "a_1_b_1", "a_1", "a_1__id_-1" ] )

  Se a array de nomes de índice incluir um índice inexistente, o método errará sem eliminar nenhum dos índices especificados.

  Dica

  Para obter os nomes dos índices, utilize o método db.collection.getIndexes().

O método db.collection.dropIndexes() usa o seguinte parâmetro opcional:

Parâmetro	Tipo	Descrição
indexes	string ou documento ou array de strings	Opcional. Especifica o índice ou índices a serem eliminados. Para descartar todos, exceto o índice _id da coleção, omita o parâmetro. Para soltar um único índice, especifique o nome do índice, o documento de especificação do índice (a menos que o índice seja um índice de texto) ou uma array do nome do índice. Para descartar um índice de texto , especifique o nome do índice ou uma array do nome do índice em vez do documento de especificação do índice. Para eliminar vários índices, especifique um array dos nomes dos índices.

Comportamento

A partir do MongoDB 6.0, db.collection.dropIndexes() gera um erro se você tentar usá-lo para remover o último índice compatível com chave de shard restante. Passar "*" para db.collection.dropIndexes() descarta todos os índices, exceto o índice _id e o último índice compatível com chave de shard restante, se houver.

A partir do MongoDB 5.2, você pode usar db.collection.dropIndexes() para descartar índices existentes na mesma coleção, mesmo que haja uma criação em andamento em outro índice. Em versões anteriores, tentar descartar um índice diferente durante uma construção de índice em andamento resulta em um erro BackgroundOperationInProgressForNamespace .