drop (comando de banco de dados)

Definição

drop

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

Dica

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

Os métodos auxiliares são convenientes para os mongosh usuários, mas podem não retornar o mesmo nível de informações que os comandos do banco de dados . Nos casos em que a conveniência 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 db.collection.drop() equivalente.

Comportamento

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