dropRole (comando de banco de dados)

Definição

dropRole: Exclui um role definido pelo usuário do reconhecimento de data center no qual você executa o comando.
Dica
In mongosh, this command can also be run through the db.dropRole() helper method.
Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

Compatibilidade

Esse comando está disponível em implantações hospedadas nos seguintes ambientes:

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

Importante

Este comando não é aceito em clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.

Sintaxe

O comando tem a seguinte sintaxe:

db.runCommand(
   {
     dropRole: "<role>",
     writeConcern: { <write concern> },
     comment: <any>
   }
)

Campos de comando

O comando tem os seguintes campos:

Campo	Tipo	Descrição
`dropRole`	string	O nome do role definido pelo usuário a ser removido do reconhecimento de data center.
`writeConcern`	documento	Opcional. O nível da write concern para a operação. Consulte Especificação de write concern.
`comment`	any	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).

Comportamento

Autenticação

Quando um papel é descartado em um mongod, os usuários autenticados anteriormente permanecem conectados ao reconhecimento de data center, mas perdem imediatamente o privilégio do papel.

Quando uma função é descartada em um mongos, os usuários autenticados anteriormente permanecem conectados ao reconhecimento de data center, mas perdem o privilégio da função quando o cache é atualizado. O cache é atualizado automaticamente após o tempo especificado com o parâmetro userCacheInvalidationIntervalSecs ou manualmente quando você executa o comando invalidateUserCache .

Acesso necessário

Você deve ter a dropRole ação em um banco de dados para eliminar um role desse banco de dados.

Exemplo

As seguintes operações removem o role readPrices do reconhecimento de data center products:

use products
db.runCommand(
   {
     dropRole: "readPrices",
     writeConcern: { w: "majority" }
   }
)

Voltar

createRole

Remover todas as funções do banco de dados