createUsr()

语法

db.createUsr( , , [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"} )