Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Comandos de banco de dados
/
Gerenciamento de usuários

dropUser

Nesta página

  • Definição
  • Compatibilidade
  • Sintaxe
  • Campos de comando
  • Acesso necessário
  • Exemplo

Definição

dropUser

Remove o usuário do banco de dados no qual você executa o comando.

Dica

Em mongosh, este comando também pode ser executado por meio do método auxiliar db.dropUser() .

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 MongoDB na nuvem

Observação

Este comando não tem suporte em clusters M10 . Para obter mais informações, 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(
   {
     dropUser: "<user>",
     writeConcern: { <write concern> },
     comment: <any>
   }
)

Campos de comando

O comando tem os seguintes campos:

Campo
Tipo
Descrição
dropUser
string
O nome do usuário a ser excluído. Você deve emitir o comando dropUser ao usar o banco de dados onde o usuário existe.
writeConcern
documento

Opcional. O nível da write concern para a operação. Consulte Especificação de write concern.

comment
qualquer

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

Antes de eliminar um usuário que tenha a função userAdminAnyDatabase, certifique-se de que haja pelo menos outro usuário com privilégios de administração de usuários.

Acesso necessário

É necessário ter a dropUser ação em um banco de dados para eliminar um usuário desse banco de dados.

Exemplo

A seguinte sequência de operações em mongosh remove reportUser1 do banco de dados products:

use products
db.runCommand( {
   dropUser: "reportUser1",
   writeConcern: { w: "majority", wtimeout: 5000 }
} )

Voltar

dropAllUsersFromDatabase

Próximo

grantRolesToUser

Nesta página