Menu Docs

Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB

Eliminar função

Nesta página

  • Definição
  • Comportamento
  • Acesso obrigatório
  • Exemplo

Definição

dropRole

Exclui um role definido pelo usuário do reconhecimento de data center no qual você executa o comando.

Dica

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

Os métodos auxiliares são convenientes 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 conveniência não for necessária ou os campos de retorno adicionais forem necessários, use o comando de banco de dados.

O comando dropRole utiliza a seguinte sintaxe:

{
  dropRole: "<role>",
  writeConcern: { <write concern> },
  comment: <any>
}

O comando dropRole 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
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).

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 obrigató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" }
   }
)
← Criar uma função
Remover todas as funções do banco de dados →

Nesta página