新增数据记录

操作步骤

1.通过 数据表名 实例化一个 TableObject 对象，操作该对象即相当于操作对应的数据表

let MyTableObject = new BaaS.TableObject(tableName)

参数说明

参数名 类型 说明
tableName string 数据表名

2.本地创建一条空记录

let MyRecord = MyTableObject.create()

3.为上面创建的空记录赋值

MyRecord.set(data)

该方法支持两种类型的赋值操作：

a.一次性赋值：

  1. MyRecord.set({
  2.   key1: value1,
  3.   key2: value2
  4. })

b.逐个赋值

  1. MyRecord.set(key1, value1)
  2. MyRecord.set(key2, value2)

info

  • 对同一字段进行多次 set 操作，后面的数据会覆盖掉前面的数据
  • 若插入数据中包含 created_at, updated_at 这几个字段，则最终生成的数据中这几个字段将以插入数据中设置的字段值为准。

4.将创建的记录保存到服务器

MyRecord.save()

通过上面的四个步骤，即完成了一条记录的插入，具体操作阅读以下内容。

info 注意：云函数中创建数据的 created_by 字段需手动指定，否则将会是应用企业的超级管理员的用户 ID。

具体参考：关于 created_by 字段

添加普通数据

请求示例

{% tabs createProductAsync=”async/await”, createProductPromise=”promise” %} {% content “createProductAsync” %}

  1. exports.main = async function createProduct() {
  2.   try {
  3.     let tableName = 'product'
  4.     let Product = new BaaS.TableObject(tableName)
  5.     let product = Product.create()
  7.     // 设置方式一
  8.     let apple = {
  9.       name: 'apple',
  10.       price: 1,
  11.       desc: ['good'],
  12.       amount: 0
  13.     }
  14.     let res = await product.set(apple).save()
  15.     //success
  16.     console.log(res)
  18.     // 设置方式二
  19.     product.set('name', 'apple')
  20.     product.set('price', 1)
  21.     product.set('desc', ['good'])
  22.     product.set('amount', 0)
  24.     let res = await product.save()
  25.     //success
  26.     console.log(res)
  27.     return res
  28.   } catch(err) {
  29.     // error
  30.     throw err
  31.   }
  32. }

{% content “createProductPromise” %}

  1. function createProduct() {
  2.   let tableName = 'product'
  3.   let Product = new BaaS.TableObject(tableName)
  4.   let product = Product.create()
  6.   // 设置方式一
  7.   let apple = {
  8.     name: 'apple',
  9.     price: 1,
  10.     desc: ['good'],
  11.     amount: 0
  12.   }
  13.   product.set(apple).save().then(res => {
  14.     // success
  15.     callback(null, res)
  16.   }).catch(err => {
  17.     // error
  18.     callback(err)
  19.   })
  21.   // 设置方式二
  22.   product.set('name', 'apple')
  23.   product.set('price', 1)
  24.   product.set('desc', ['good'])
  25.   product.set('amount', 0)
  27.   product.save().then(res => {
  28.     // success
  29.     callback(null, res)
  30.   }).catch(err => {
  31.     // error
  32.     callback(err)
  33.   })
  34. }

{% endtabs %}

返回示例

回调中的 res 对象结构如下，其中 res.data 为新增的数据行：

  1. {
  2.   "status": 201,
  3.   "data": {
  4.     "_id": "59a3c2b5afb7766a5ec6e84e",
  5.     "amount": 0,
  6.     "created_at": 1503904437,
  7.     "created_by": 36395395,
  8.     "desc": ["good"],
  9.     "id": "59a3c2b5afb7766a5ec6e84e",
  10.     "name": "apple",
  11.     "price": 1.0,
  12.     "read_perm": ["user:*"],
  13.     "updated_at": 1503904437,
  14.     "write_perm": ["user:*"]
  15.   }
  16. }

err 对象结构请参考错误码和 HError 对象

常见错误：

错误码 err.code 可能的原因
400 1. 提交的 ACL 权限不合法 、2. 提交的数据的字段类型不匹配、 3. 提交的数据中没有包含必填项 4. 重复创建数据（设置了唯一索引）
403 没有权限写入数据
404 写入的数据表不存在

info 对于不合法的数据，知晓云会进行过滤，比如开发者尝试在 integer 类型的字段写入 string 类型的数据，该操作不会报错而是会忽略对该字段的修改。 因此可以检查 res.data 中对应的字段来判断某些字段是否添加成功。

添加日期时间 Date 类型的数据

数据表允许添加时间日期类型的列，为该类型的记录赋值，需要使用 ISO Date 格式的字符串，如 Product 表定义一个时间日期类型的列 expiration_time，创建一条记录时，该字段的赋值操作如下：

  1. let isoStr = ((new Date()).toISOString()).toString()
  2. product.set('expiration_time', isoStr)

添加 file 类型数据

请求示例

{% tabs addFileAsync=”async/await”, addFilePromise=”promise” %} {% content “addFileAsync” %}

  1. exports.main = async function addFile() {
  2.   try {
  3.     let MyFile = new BaaS.File()
  4.     await MyFile.upload(params)
  5.     product.set('manual', res.data.file)
  6.     let res = await product.save()
  7.     console.log(res)
  8.     return res
  9.   } catch(err) {
  10.     // error
  11.     throw err
  12.   }
  13. }

{% content “addFilePromise” %}

  1. function addFile() {
  2.   let MyFile = new BaaS.File()
  3.   MyFile.upload(params).then(res => {
  4.     product.set('manual', res.data.file)
  5.     product.save().then(res=>{
  6.       console.log(res)
  7.       callback(null, res)
  8.     }).catch(err => {
  9.       // error
  10.       callback(err)
  11.     })
  12.   })
  13. }

{% endtabs %}

返回示例

res 结构如下

  1. {
  2.   "status": 201,
  3.   "data": {
  4.     "_id": "5bbac6e7bd66033df7fd0aac",
  5.     "created_at": 1538967271,
  6.     "created_by": 61736923,
  7.     "file": {
  8.       "cdn_path": "1g9LgkbXEdbXwAJT.jpg",
  9.       "created_at": 1538967271,
  10.       "id": "5bbac6e6bd66033efcfd0a95",
  11.       "mime_type": "image/jpeg",
  12.       "name": "6b86e382a1e3294.o6zAJs5dCuYRqqJOq0MwNPlGiFVM.UxdrZqves41D1cd738e01dc1c7417c03d046e96408cc.jpg",
  13.       "path": "https://cloud-minapp-11033.cloud.ifanrusercontent.com/1g9LgkbXEdbXwAJT.jpg",
  14.       "size": 6151
  15.     },
  16.     "id": "5bbac6e7bd66033df7fd0aac",
  17.     "name": "new",
  18.     "read_perm": ["user:*"],
  19.     "updated_at": 1538967271,
  20.     "write_perm": ["user:*"]
  21.   }
  22. }

添加 geojson 类型数据

查看 地理位置操作 章节

添加 object 类型数据

对象内的属性名只能包含字母、数字和下划线，必须以字母开头，比如 {$ifanr.x: 123} 和 {知晓云: "test"} 是错误的。

添加 array 类型数据

添加 array 类型数据的方法与添加其他类型数据的方法基本一致。区别在于，array 类型数据是将一个的数组赋值给某个字段。

array 类型数据中的元素类型，要与预先在知晓云平台设定的字段类型一致。否则创建的数据将不包含该 array 类型的字段。

  1. // 元素类型为 integer
  2. let Table = new BaaS.TableObject(tableName)
  3. let record = Table.create()
  4. record.set('array_int', [1, 2, 3])
  5. record.save()
  1. // 元素类型为 string
  2. let Table = new BaaS.TableObject(tableName)
  3. let record = Table.create()
  4. record.set('array_str', ['a', 'b', 'c'])
  5. record.save()
  1. // 元素类型为 object
  2. let table = new baas.tableobject(tablename)
  3. let record = table.create()
  4. let obj_1 = {a: 10}
  5. let obj_2 = {b: 20}
  6. record.set('array_obj', [obj_1, obj_2])
  7. record.save()
  1. // 元素类型为 geojson
  2. let Table = new BaaS.TableObject(tableName)
  3. let record = Table.create()
  4. let point = new BaaS.GeoPoint(10, 10)
  5. record.set('array_geo', [point])
  6. record.save()
  1. // 元素类型为 file
  2. let Table = new BaaS.TableObject(tableName)
  3. let record = Table.create()
  4. let MyFile = new BaaS.File()
  5. MyFile.upload(fileParam).then(res => {
  6.   let file = res.data.file  // res.data 为 Object 类型
  7.   record.set('array_file', [file])
  8.   return record.save()
  9. })
  1. // 元素类型为 date
  2. let Table = new BaaS.TableObject(tableName)
  3. let record = Table.create()
  4. let date = new Date().toISOString()
  5. record.set('array_date', [date])
  6. record.save()

添加 pointer 类型数据

info 每张表最多能建立 3 个 pointer 类型的字段，如有更多需求，请提交工单说明
pointer 指向的数据表，不能改名或删除

假设现在有一张 Article 表, Article 表部分字段如下:

字段名 字段类型 说明
comment pointer 指向了 Comment 表
user pointer 指向了 _userprofile 表

现在在 Article 表中新增一条数据，其中:

comment 字段指向了 Comment 表中 id 为 5bad87ab0769797b4fb27a1b 的数据行

user 字段指向了 _userprofile 表中 id 为 69147880 的数据行

{% tabs addPointerAsync=”async/await”, addPointerPromise=”promise” %} {% content “addPointerAsync” %}

  1. exports.main = async function addPointer() {
  2.   try {
  3.     // 获取一个 tableRecord 实例
  4.     let Comment = new BaaS.TableObject('Comment')
  5.     // 5bad87ab0769797b4fb27a1b 为 Comment 表中某行数据的 id
  6.     let comment = Comment.getWithoutData('5bad87ab0769797b4fb27a1b')
  7.     // 69147880 为 _userprofile 表中某行数据的 id
  8.     let user = new BaaS.User().getWithoutData(69147880)
  10.     // 在 city 表中创建一行数据
  11.     let Article = new BaaS.TableObject('Article')
  12.     let article = Article.create()
  14.     // 给 pointer 字段赋值
  15.     Article.set('comment', comment)
  16.     Article.set('user', user)
  18.     let res = await article.save()
  19.     // success
  20.     return res
  21.   } catch (err) {
  22.     // error
  23.     throw err
  24.   }
  25. }

{% content “addPointerPromise” %}

  1. function addPointer() {
  2.   // 获取一个 tableRecord 实例
  3.   let Comment = new BaaS.TableObject('Comment')
  4.   // 5bad87ab0769797b4fb27a1b 为 Comment 表中某行数据的 id
  5.   let comment = Comment.getWithoutData('5bad87ab0769797b4fb27a1b')
  6.   // 69147880 为 _userprofile 表中某行数据的 id
  7.   let user = new BaaS.User().getWithoutData(69147880)
  9.   // 在 city 表中创建一行数据
  10.   let Article = new BaaS.TableObject('Article')
  11.   let article = Article.create()
  13.   // 给 pointer 字段赋值
  14.   Article.set('comment', comment)
  15.   Article.set('user', user)
  17.   article.save().then(res=>{
  18.     // success
  19.     callback(null, res)
  20.   }).catch(e => {
  21.     // error
  22.     callback(err)
  23.   })
  24. }

{% endtabs %}

返回示例

res 结构如下

  1. {
  2.   "status": 201,
  3.   "data": {
  4.     "_id": "5be5283240507206d6938ba8",
  5.     "created_at": 1541744690,
  6.     "created_by": 3,
  7.     "id": "5be5283240507206d6938ba8",
  8.     "comment": {
  9.       "id": "5bad87ab0769797b4fb27a1b",
  10.       "_table": "Comment"
  11.     },
  12.     "user": {
  13.       "id": 69147880,
  14.       "_table": "_userprofile"
  15.     },    
  16.     "read_perm": [ "user:*" ],
  17.     "updated_at": 1541744690,
  18.     "write_perm": [ "user:*" ] }
  19. }

新增数据项

TableObject.createMany([item,...])

info 批量创建记录的数量，最大限制为 1000

参数说明

参数名 类型 说明
item object 符合表结构的对象

请求示例

{% tabs createManyAsync=”async/await”, createManyPromise=”promise” %} {% content “createManyAsync” %}

  1. exports.main = async function createMany() {
  2.   try {
  3.     let MyTableObject = new BaaS.TableObject(tableName)
  5.     const records = [{
  6.       name: 'apple',
  7.       price: 1,
  8.       desc: ['good'],
  9.       amount: 0
  10.     }, {
  11.       name: 'banana',
  12.       price: 2,
  13.       desc: ['good'],
  14.       amount: 1
  15.     }]
  17.     let res = await MyTableObject.createMany(records)
  18.     console.log(res.data.succeed)
  19.     return res
  20.   } catch(err) {
  21.     // error
  22.     throw err
  23.   }
  24. }

{% content “createManyPromise” %}

  1. function createMany() {
  2.   let MyTableObject = new BaaS.TableObject(tableName)
  4.   const records = [{
  5.     name: 'apple',
  6.     price: 1,
  7.     desc: ['good'],
  8.     amount: 0
  9.   }, {
  10.     name: 'banana',
  11.     price: 2,
  12.     desc: ['good'],
  13.     amount: 1
  14.   }]
  16.   MyTableObject.createMany(records).then(res => {
  17.     console.log(res.data.succeed)
  18.     callback(null, res)
  19.   }).catch(err => {
  20.     // error
  21.     callback(err)
  22.   })
  23. }

{% endtabs %}

返回示例

回调中 res 结构如下:

  1. {
  2.   "status": 201, // 201 表示创建成功, 注意这不代表所有数据都插入成功，具体要看 operation_result 字段
  3.   "data": {
  4.     "succeed": 10, // 成功插入记录数
  5.     "total_count": 10, // 总的待插入记录数
  6.     "operation_result": [  // 创建的详细结果
  7.        {
  8.          "success": {      // 成功时会有 success 字段
  9.            "id": "5bffbab54b30640ba8135650",
  10.            "created_at": 1543486133
  11.          }
  12.        },
  13.        {
  14.          "success": {
  15.            "id": "5bffbab54b30640ba8135651",
  16.            "created_at": 1543486133
  17.          }
  18.        },
  19.        {
  20.          "error": {     // 失败时会有 error 字段
  21.            "code": 16837,
  22.            "err_msg": "数据更新失败，具体错误信息可联系知晓云微信客服：minsupport3 获取。"
  23.          }
  24.        }
  25.      ] 
  26.   }
  27. }

err 对象结构请参考错误码和 HError 对象

常见错误：

错误码 err.code 可能的原因
400 1. 提交的 ACL 权限不合法 、2. 提交的数据的字段类型不匹配、 3. 提交的数据中没有包含必填项 4. 重复创建数据（设置了唯一索引）
403 没有权限写入数据
404 写入的数据表不存在

批量创建时不触发触发器

info 批量创建记录的数量，最大限制为 1000

  1. // 知晓云后台设置的触发器将不会被触发
  2. MyTableObject.createMany(records, {enableTrigger: false}).then(res => {
  3.    console.log(res.data.succeed)
  4. }, err => {
  5.   //err 为 HError 对象
  6. })

返回示例

  1. {
  2.   "status": 201, // 201 表示创建成功, 注意这不代表所有数据都插入成功，具体要看 operation_result 字段
  3.   "data": {
  4.     "succeed": 10, // 成功插入记录数
  5.     "total_count": 10, // 总的待插入记录数
  6.     "operation_result": [  // 创建的详细结果
  7.        {
  8.          "success": {      // 成功时会有 success 字段
  9.            "id": "5bffbab54b30640ba8135650",
  10.            "created_at": 1543486133
  11.          }
  12.        },
  13.        {
  14.          "success": {
  15.            "id": "5bffbab54b30640ba8135651",
  16.            "created_at": 1543486133
  17.          }
  18.        },
  19.        {
  20.          "error": {     // 失败时会有 error 字段
  21.            "code": 16837,
  22.            "err_msg": "数据更新失败，具体错误信息可联系知晓云微信客服：minsupport3 获取。"
  23.          }
  24.        }
  25.      ] 
  26.   }
  27. }

设置数据行 ACL

有时候我们需要设置特定数据行的 ACL 权限，之前只能在知晓云控制台修改数据行 ACL，现在云函数中支持通过代码来完该操作了。

假设现在需要在 product 表中创建一行记录，并指定 ACL 为 用户组【开发人员】和创建者可写 、创建者可读。

其中用户组 开发人员 的 group_id 为 656、创建者的 user_id (对应 _userprofile 表中的 id 列) 为 37087886。

write_perm 和 read_perm 的可选值请参考 数据表操作-创建数据表 小节

示例代码

{% tabs setACLAsync=”async/await”, setACLPromise=”promise” %} {% content “Async” %}

  1. exports.main = async function setACL() {
  2.   try {
  3.     let Product = new BaaS.TableObject('product')
  4.     let record = Product.create()
  6.     record.set('write_perm', [ "gid:656", "user:37087886"])
  7.     record.set('read_perm', [ "user:37087886" ])
  9.     let res = await record.save()
  10.     // success
  11.     return res
  12.   } catch(e) {
  13.     // error
  14.     throw err
  15.   }
  16. }

{% content “setACLPromise” %}

  1. function setACL() {
  2.   let Product = new BaaS.TableObject('product')
  3.   let record = Product.create()
  5.   record.set('write_perm', [ "gid:656", "user:37087886"])
  6.   record.set('read_perm', [ "user:37087886" ])
  8.   record.save().then(res=>{
  9.     // success
  10.     callback(null, res)
  11.   }).catch(err => {
  12.     // error
  13.     callback(err)
  14.   })
  15. }

{% endtabs %}

返回示例

res 结构如下：

  1. {
  2.   "status": 201,
  3.   "data": {
  4.     "_id": "5bffbab54b30640ba8135650",
  5.     "created_at": 1544423640,
  6.     "created_by": 16042162,
  7.     "read_perm": [
  8.       "user:37087886"
  9.     ],
  10.     "updated_at": 1544593093,
  11.     "write_perm": [
  12.       "gid:656",
  13.       "user:37087886"
  14.     ]
  15.   }
  16. }