derrubar

Definição

drop

O comando drop remove uma collection inteira de um banco de dados.

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.

Compatibilidade

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

• 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 comando tem a seguinte sintaxe:

db.runCommand(
   {
     drop: <collection_name>,
     writeConcern: <document>,
     comment: <any>
   }
)

Campos de comando

O comando utiliza os seguintes campos:

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

Comportamento

• 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.