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

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 auxiliar 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 auxiliar db.collection.drop() criam uma invalidar para quaisquer Alterar 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 comando drop e o método db.collection.drop() retornam um erro se você tentar eliminar uma coleção no banco de dados de administração ou no 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.