db.collection.drop() (método mongosh)

Definição

db.collection.drop(<options>)

Remove uma collection ou visualização do banco de dados. O método também remove quaisquer índices associados à coleção descartada. drop() é um wrapper em torno do drop comando.

Retorna:	true

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

• MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

• MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Sintaxe

O método drop() tem o seguinte formulário:

db.collection.drop( { writeConcern: <document> } )

O método drop() recebe um documento opcional com o seguinte campo:

Comportamento

• O método drop() e o comando drop criam um evento de invalidação para qualquer change stream aberto na coleção descartada.

• O método db.collection.drop() e o comando drop abortam qualquer construção de índice em andamento na coleção de destino antes de descartar a coleção.

  Para conjuntos de réplicas ou conjuntos de réplicas de estilhaços, abortar um índice no primário não anula simultaneamente as compilações de índice secundário. O MongoDB tenta abortar as compilações em andamento para os índices especificados no primário e, se for bem-sucedido, cria uma entrada de oplog abort associada. Os membros secundários com compilações replicadas em andamento aguardam uma entrada de oplog de confirmação ou abortamento do primário antes de confirmar ou abortar a compilação do índice.

• A eliminação de uma coleção exclui seus intervalos de zonas/tags associados.

• A partir do MongoDB 5.0, o comando drop e o método db.collection.drop() retornam um erro se você tentar descartar uma coleção no banco de dados admin ou no banco de dados de configuração a partir de um mongos. Para descartar essas coleções, conecte-se ao servidor de configuração e execute o comando lá.

  Aviso

  Soltar coleções no banco de dados admin ou no banco de dados de configuração pode deixar seu cluster em um estado inutilizável.

• A partir do MongoDB 6.0, drop() descarta a coleção especificada e quaisquer coleções internas relacionadas a campos criptografados.

  Importante

  O comportamento do método mongosh drop() difere do comportamento do método drop do driver. A conexão do driver deve ter a criptografia automática habilitada para descartar a coleção especificada e quaisquer coleções internas relacionadas a campos criptografados. mongosh sempre descarta a coleção especificada e quaisquer coleções internas relacionadas a campos criptografados.

Exemplo

db.students.drop()

db.students.drop( { writeConcern: { w: 1, j: true } } )