• createUsr()
    • 语法
    • 参数描述
      • options取值
    • 返回值
    • 示例

    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"} )