dropUsr()

名称

dropUsr - 删除数据库用户

语法

db.dropUsr( <name>, <password> )

db.dropUsr( <User> )

db.dropUsr( <CipherUser> )

类别

Sdb

描述

该函数用于删除数据库用户。

参数

Note:

• 在删除最后一个角色为 "admin" 的用户时，需要确保已经没有角色为 "monitor" 的用户存在，否则删除会失败

返回值

函数执行成功时，无返回值。

函数执行失败时，将抛异常并输出错误信息。

错误

当异常抛出时，可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南。

版本

v2.0 及以上版本

示例

• 删除用户名为 sdbadmin，密码为 sdbadmin 的用户。

  > db.dropUsr( "sdbadmin", "sdbadmin" )

• 使用 User 对象删除用户名为 sdbadmin，密码为 sdbadmin 的用户。

  > var a = User( "sdbadmin", "sdbadmin" )
  > db.dropUsr( a )

• 使用 CipherUser 对象删除用户名为 sdbadmin，密码为 sdbadmin 的用户（密文文件中必须存在用户名为 sdbadmin，密码为 sdbadmin 的用户信息，关于如何在密文文件中添加删除密文信息，详细可见sdbpasswd）。

  > var a = CipherUser( "sdbadmin" )
  > db.dropUsr( a )