dropDatabase (comando de banco de dados)

Definição

dropDatabase: The dropDatabase command drops the current database, deleting the associated data files.

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 a 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

Sintaxe

O comando tem a seguinte sintaxe:

db.runCommand(
   {
     dropDatabase: 1,
     writeConcern: <document>,
     comment: <any>
   }
)

Campos de comando

O comando usa os seguintes campos opcionais:

Campo

Descrição

writeConcern

Opcional. Um documento expressando o write concern a ser usado se for maior que "majority"

{ w: <value>, j: <boolean>, wtimeout: <number> }

Omita o uso da preocupação de gravação padrão/mínima de"majority".

Quando emitida em um conjunto de réplicas, se a write concern especificada resultar em menos confirmações de membro do que a write concern "majority" , a operação usará "majority" . Caso contrário, a write concern especificada será usada.

Quando emitido em um cluster fragmentado, o MongoDB converte a write concern especificada em "majority".

Consulte também Comportamento.

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:

mensagens de log do mongod, no campo attr.command.cursor.comment.
Saída do perfil do banco de dados, no campo command.comment.
Saída de currentOp, no campo command.comment.

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

mongosh also provides the helper method db.dropDatabase().

Comportamento

Bloqueios

A operação requer somente um bloqueio exclusivo do banco de dados (X).

Gerenciamento de usuários

Este comando não exclui os usuários associados ao banco de dados atual. Para soltar os usuários associados, execute o comando dropAllUsersFromDatabase no banco de dados que você está excluindo.

Indexes

The db.dropDatabase() method and dropDatabase command abort any in-progress index builds on collections in the target database before dropping the database. Aborting an index build has the same effect as dropping the built index.

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.

Conjunto de Réplica e Clusters Compartilhados

Conjuntos de réplicas

At minimum, dropDatabase waits until all collections drops in the database have propagated to a majority of the replica set members (i.e. uses the write concern "majority").

Se você especificar uma referência de escrita que requer confirmação de menos que a maioria, o comando usará referência de escrita "majority".

Se você especificar uma referência de escrita que exige confirmação de mais do que a maioria, o comando usará a referência de escrita especificada.

Clusters fragmentados

Quando emitido em um cluster fragmentado, o MongoDB converte a write concern especificada em "majority".

If you intend to create a new database with the same name as the dropped database, you must run the dropDatabase command on a mongos.

Isso garante que todos os nós do cluster atualizem seu cache de metadados, o qual inclui o local do fragmento primário do novo banco de dados. Caso contrário, você poderá perder dados nas leituras e talvez não grave dados no fragmento correto. Para recuperar, você deve intervir manualmente.

A partir do MongoDB,5.0 o comando dropDatabase e o método retornam um erro db.dropDatabase() se você tentar soltar o banco de dados admin ou o banco de dados de configuração de mongos um.

Aviso

Descartar o banco de dados de admin ou o banco de dados de configuração pode deixar o cluster em um estado inutilizável.

Fluxos de alterações

The db.dropDatabase() method and dropDatabase create an invalidate Event for any MongoDB Change Streams opened on the dropped database or opened on the collections in the dropped database.

Exemplo

The following example in mongosh uses the use <database> operation to switch the current database to the temp database and then uses the dropDatabase command to drop the temp database:

use temp
db.runCommand( { dropDatabase: 1 } )

Dica

dropAllUsersFromDatabase

Voltar

derrubar

dropConnections