derrubar
Nesta página
Sintaxe
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 assistentedrop()
.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
Observação
Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas para todos os comandos, consulte Comandos sem suporte.
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:
{ 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 Quando emitido em um cluster fragmentado, |
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()
.
Comportamento
A partir do MongoDB 5.0, o comando
drop
e o métododb.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 comandodrop
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 assistentedb.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 odb.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 ummongos
. 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.
Bloqueio de recursos
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.