Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

derrubar

Nesta página

  • Sintaxe
  • Compatibilidade
  • Sintaxe
  • Comportamento
drop

O comando drop remove uma collection inteira de um banco de dados de dados. O comando tem a seguinte sintaxe:

Dica

Em mongosh, esse comando também pode ser executado por meio do método assistente drop() .

Os métodos auxiliares são práticos para os usuários mongosh, mas podem não retornar o mesmo nível de informações que os comandos do banco de dados. Nos casos em que a praticidade não for necessária ou os campos de retorno adicionais forem necessários, use o comando de banco de dados.

Esse comando está disponível em implantações hospedadas nos seguintes ambientes:

  • MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

Observação

Este comando é suportado em todos os clusters do MongoDB Atlas . Para obter informações sobre o suporte do Atlas para todos os comandos, consulte Comandos não suportados.

  • 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

O comando tem a seguinte sintaxe:

{ drop: <collection_name>, writeConcern: <document>, comment: <any> }
The command takes the following fields:
Campo
Descrição
drop
O nome da coleção a ser descartada.
writeConcern

Opcional. Um documento que expressa a preocupação de gravação do comando drop . Omita para usar a preocupação de gravação padrão.

Quando emitido em um cluster fragmentado, mongos converte a preocupação de gravação do comando drop e seu auxiliar db.collection.drop() em "majority".

comment

Opcional. Um comentário fornecido pelo usuário para anexar a este comando. Depois de definido, esse comentário aparece junto com os registros desse comando nos seguintes locais:

Um comentário pode ser qualquer tipo BSON válido (string, inteiro, objeto, array etc).

mongosh fornece o método assistente equivalente db.collection.drop().

  • A partir do MongoDB 5.0, o comando drop e o método db.collection.drop() gerarão um erro se for passado um parâmetro não reconhecido.

  • Este comando também remove quaisquer índices associados à coleção descartada.

  • O método db.collection.drop() e o comando drop abortam qualquer compilaçã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.

  • O comando drop e seu assistente db.collection.drop() criam uma invalidar para quaisquer Change Streams abertos na coleção descartada.

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

  • A partir do MongoDB 5.0, o drop comando e o db.collection.drop() método retornam um erro se você tentar eliminar uma coleção no banco de dados de banco de dados admin ou no banco de banco de dados de configuração a partir de um mongos. Para eliminar 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.

drop obtém um bloqueio exclusivo na coleção especificada durante a operação. Todas as operações subsequentes na coleção devem aguardar até que drop libere o bloqueio.

Voltar

operação atual