文档中心

SequoiaDB 简介

快速入门

安装部署

数据库实例

分布式引擎

SAC管控中心

SequoiaPerf性能分析工具

参考手册

常见问题及解答(FAQ)

版本信息

createUsr()

名称

createUsr - 创建数据库用户

语法

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

db.createUsr( <User>, [options] )

db.createUsr( <CipherUser>, [options] )

类别

Sdb

描述

该函数用于创建数据库用户,防止非法用户操作数据库。

参数

参数名 参数类型 描述 是否必填
name string 用户名
password string 密码
User object User 对象
CipherUser object CipherUser 对象
options Json 扩展选项

options取值

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

Note:

  • 该接口只能用于集群模式。
  • 当数据库创建了用户,连接数据库必须指定用户名和密码。
  • 数据库用户名和密码的限制请参考数据库限制

返回值

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

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

错误

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

版本

v2.0 及以上版本

示例

  • 创建用户名为 sdbadmin,密码为 sdbadmin 的用户,并设置审计日志掩码。

    > db.createUsr( "sdbadmin", "sdbadmin", { AuditMask: "DDL|DML|!DQL" } )
  • 使用 User 对象创建用户名为 sdbadmin,密码为 sdbadmin 的用户。

    > var a = User( "sdbadmin", "sdbadmin" )
    > db.createUsr( a )
  • 使用 CipherUser 对象创建用户名为 sdbadmin,密码为 sdbadmin 的用户(密文文件中必须存在用户名为 sdbadmin,密码为 sdbadmin 的用户信息,关于如何在密文文件中添加删除密文信息,详细可见 sdbpasswd)。

    > var a = CipherUser( "sdbadmin" )
    > db.createUsr( a )
回到顶部