createUsr()

语法

db.createUsr( <name>, <password>, [options] )

为数据库创建数据库用户名和密码，防止非法用户对数据库进行非法操作。

参数描述

参数名参数类型描述是否必填
namestring用户名是
passwordstring密码是
optionsJson扩展选项否

options取值

选项名称取值类型描述
AuditMaskString用户审计日志配置掩码，取值列表：ACCESS、CLUSTER、SYSTEM、DML、DDL、DCL、DQL、INSERT、DELETE、UPDATE、OTHER；ALL表示全部开启，NONE表示全部不开启；可以使用‘|’连接多个取值。当某位掩码未配置时，则继承节点相应的配置掩码；也可以通过 ‘!’ 来禁止某位掩码的继承

Note:

  • 该接口只能用于集群模式。
  • 当为数据库设置了用户名和密码时，只能使用正确的用户名和密码才能登录数据库进行相关操作。

返回值

无返回值，出错抛异常，并输出错误信息，可以通过 getLastErrMsg() 获取错误信息 或 通过 getLastError() 获取错误码。关于错误处理可以参考常见错误处理指南 。

示例

  • 为数据库创建用户名为 admin，密码为 admin 的命令如下：

    1. > db.createUsr( "admin", "admin" )

  • 使用鉴权连接到节点

    1. > var db = new Sdb("localhost", 11810, "admin", "admin")

  • 创建用户，并设置审计日志

    1. > db.createUsr( "user2", "user2", {AuditMask:"DDL|DML|!DQL"} )