db.createUser()方法的使用

定义：
创建一个数据库新用户用db.createUser()方法，如果用户存在则返回一个用户重复错误。

语法：
db.createUser(user, writeConcern)
user这个文档创建关于用户的身份认证和访问信息；
writeConcern这个文档描述保证MongoDB提供写操作的成功报告。

image.png

user文档字段介绍：
user字段，为新用户的名字；
pwd字段，用户的密码；
cusomData字段，为任意内容，例如可以为用户全名介绍；
roles字段，指定用户的角色，可以用一个空数组给新用户设定空角色；
在roles字段,可以指定内置角色和用户定义的角色。

Built-In Roles（内置角色）：
1. 数据库用户角色：read、readWrite;
2. 数据库管理角色：dbAdmin、dbOwner、userAdmin；
3. 集群管理角色：clusterAdmin、clusterManager、clusterMonitor、hostManager；
4. 备份恢复角色：backup、restore；
5. 所有数据库角色：readAnyDatabase、readWriteAnyDatabase、userAdminAnyDatabase、dbAdminAnyDatabase
6. 超级用户角色：root
// 这里还有几个角色间接或直接提供了系统超级用户的访问（dbOwner 、userAdmin、userAdminAnyDatabase）
7. 内部角色：__system
关于每个角色所拥有的操作权限可以点击上面的内置角色链接查看详情。

writeConcern文档
w选项：允许的值分别是 1、0、大于1的值、"majority"、<tag set>；
j选项：确保mongod实例写数据到磁盘上的journal（日志），这可以确保mongd以外关闭不会丢失数据。设置true启用。
wtimeout：指定一个时间限制,以毫秒为单位。wtimeout只适用于w值大于1。

> use test
> db.createUser(
   {
     user: "user01",
     pwd: "Test@123",
     roles: [ "readWrite", "dbAdmin" ,"userAdmin"]
   }
);




> use admin
> db.createUser(
{
    user : "test01",
    pwd : "123456",
    roles: [ { role : "readWrite", db : "test" } ,
             { role : "dbAdmin", db : "test" } ,
             { role : "userAdmin", db : "test" }  
           ]
    }
)


在products数据库创建用户employee01，并给该用户admin数据库上clusterAdmin和readAnyDatabase的角色，products数据库上readWrite角色。

> use products
> db.createUser( { "user" : "employee01",
                 "pwd": "123456",
                 "customData" : { employeeId: 12345 },
                 "roles" : [ { role: "clusterAdmin", db: "admin" },
                             { role: "readAnyDatabase", db: "admin" },
                             "readWrite"
                             ] },
               { w: "majority" , wtimeout: 5000 } )