uniCloud 云数据库（2）

最新推荐文章于 2024-06-26 14:46:37 发布
最新推荐文章于 2024-06-26 14:46:37 发布
阅读量1.4k 收藏 19
点赞数 18
分类专栏： uniCloud 文章标签： 数据库 java 服务器
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_63358859/article/details/135587039
版权

目录

更新文档

更新指定文档

更新文档，如果不存在则创建

批量更新文档

更新并返回更新后的数据

更新数组内指定下标的元素

更新数组内匹配条件的元素

更新操作符

set

inc

mul

remove

push

pop

#unshift

shift

删除文档

 本地函数与云函数的区别

更新文档

更新指定文档

使用腾讯云时更新方法必须搭配doc、where方法使用，db.collection('test').update()会报如下错误：param should have required property 'query'

collection.doc().update(Object data)

未使用set、remove更新操作符的情况下，此方法不会删除字段，仅将更新数据和已有数据合并。

参数说明

参数类型必填说明
dataobject是更新字段的Object，{'name': 'Ben'} _id 非必填

响应参数

参数类型说明
updatedNumber更新成功条数，数据更新前后没变化时会返回0
let res = await collection.doc('doc-id').update({
  name: "Hey",
  count: {
    fav: 1
  }
});


// 更新前
{
  "_id": "doc-id",
  "name": "Hello",
  "count": {
    "fav": 0,
    "follow": 0
  }
}

// 更新后
{
  "_id": "doc-id",
  "name": "Hey",
  "count": {
    "fav": 1,
    "follow": 0
  }
}

更新数组时，已数组下标作为key即可，比如以下示例将数组arr内下标为1的值修改为 uniCloud

let res = await collection.doc('doc-id').update({
  arr: {
    1: "uniCloud"
  }
})


// 更新前
{
  "_id": "doc-id",
  "arr": ["hello", "world"]
}
// 更新后
{
  "_id": "doc-id",
  "arr": ["hello", "uniCloud"]
}

更新文档，如果不存在则创建

collection.doc().set()

注意：

此方法会覆写已有字段，需注意与update表现不同，比如以下示例执行set之后follow字段会被删除

let res = await collection.doc('doc-id').set({
  name: "Hey",
  count: {
    fav: 1
  }
})


// 更新前
{
  "_id": "doc-id",
  "name": "Hello",
  "count": {
    "fav": 0,
    "follow": 0
  }
}

// 更新后
{
  "_id": "doc-id",
  "name": "Hey",
  "count": {
    "fav": 1
  }
}

批量更新文档

collection.update()

const dbCmd = db.command
let res = await collection.where({name: dbCmd.eq('hey')}).update({
  age: 18,
})

更新并返回更新后的数据

新增于HBuilderX 3.2.0

此接口仅会操作一条数据，有多条数据匹配的情况下会只更新匹配的第一条并返回

示例

const db = uniCloud.database()
await db.collection('test').where({
  uid: '1'
}).updateAndReturn({
  score: db.command.inc(2)
})

// 更新前
{
  _id: 'xx',
  uid: '1',
  score: 0
}
// 更新后
{
  _id: 'xx',
  uid: '1',
  score: 2
}

// 接口返回值
{
  updated: 1,
  doc: {
    _id: 'xx',
    uid: '1',
    score: 2
  }
}

注意

  • 使用updateAndReturn时，不可使用field方法
  • 可以在事务中使用，可以使用transaction.where().updateAndReturn()以及transaction.doc().updateAndReturn()
  • 不同于update接口，此接口返回的updated不表示数据真的进行了更新
  • 腾讯云暂不支持doc().updateAndReturn()的写法可以使用where().updateAndReturn()替代

更新数组内指定下标的元素

const res = await db.collection('query').doc('1').update({
  // 更新students[1]
  ['students.' + 1]: {
    name: 'wang'
  }
})


// 更新前
{
  "_id": "1",
  "students": [
    {
      "name": "zhang"
    },
    {
      "name": "li"
    }
  ]
}

// 更新后
{
  "_id": "1",
  "students": [
    {
      "name": "zhang"
    },
    {
      "name": "wang"
    }
  ]
}

更新数组内匹配条件的元素

注意：只可确定数组内只会被匹配到一个的时候使用

const res = await db.collection('query').where({
	'students.id': '001'
}).update({
  // 将students内id为001的name改为li，$代表where内匹配到的数组项的序号
	'students.$.name': 'li'
})


// 更新前
{
  "_id": "1",
  "students": [
    {
      "id": "001",
      "name": "zhang"
    },
    {
      "id": "002",
      "name": "wang"
    }
  ]
}

// 更新后
{
  "_id": "1",
  "students": [
    {
      "id": "001",
      "name": "li"
    },
    {
      "id": "002",
      "name": "wang"
    }
  ]
}

更新操作符

更多数据库操作符请查看数据库操作符

set

更新指令。用于设定字段等于指定值。这种方法相比传入纯 JS 对象的好处是能够指定字段等于一个对象：

const dbCmd = db.command
let res = await db.collection('photo').doc('doc-id').update({
  count: dbCmd.set({
    fav: 1,
    follow: 1
  })
})

// 更新前
{
  "_id": "doc-id",
  "name": "Hello",
  "count": {
    "fav": 0,
    "follow": 0
  }
}

// 更新后
{
  "_id": "doc-id",
  "name": "Hello",
  "count": {
    "fav": 1,
    "follow": 1
  }
}

inc

更新指令。用于指示字段自增某个值，这是个原子操作，使用这个操作指令而不是先读数据、再加、再写回的好处是：

  1. 原子性：多个用户同时写，对数据库来说都是将字段加一，不会有后来者覆写前者的情况
  2. 减少一次请求：不需先读再写

之后的 mul 指令同理。

在文章阅读数+1、收藏+1等很多场景会用到它。如给收藏的商品数量加一：

const dbCmd = db.command

let res = await db.collection('user').where({
  _id: 'my-doc-id'
}).update({
  count: {
    fav: dbCmd.inc(1)
  }
})


// 更新前
{
  "_id": "my-doc-id",
  "name": "Hello",
  "count": {
    "fav": 0,
    "follow": 0
  }
}

// 更新后
{
  "_id": "my-doc-id",
  "name": "Hello",
  "count": {
    "fav": 1,
    "follow": 0
  }
}

请注意并没有直接提供减法操作符，如果要实现减法，仍通过inc实现。比如上述字段减1，

const dbCmd = db.command

let res = await db.collection('user').where({
  _id: 'my-doc-id'
}).update({
  count: {
    fav: dbCmd.inc(-1)
  }
})

mul

更新指令。用于指示字段自乘某个值。

以下示例将count内的fav字段乘10

const dbCmd = db.command

let res = await db.collection('user').where({
  _id: 'my-doc-id'
}).update({
  count: {
    fav: dbCmd.mul(10)
  }
})


// 更新前
{
  "_id": "my-doc-id",
  "name": "Hello",
  "count": {
    "fav": 2,
    "follow": 0
  }
}

// 更新后
{
  "_id": "my-doc-id",
  "name": "Hello",
  "count": {
    "fav": 20,
    "follow": 0
  }
}

请注意没有直接提供除法操作符，如果要实现除法，仍通过mul实现。比如上述字段除以10，

const dbCmd = db.command

let res = await db.collection('user').where({
  _id: 'my-doc-id'
}).update({
  count: {
    fav: dbCmd.mul(0.1)
  }
})

remove

更新指令。用于表示删除某个字段。如某人删除了自己一条商品评价中的评分：

const dbCmd = db.command
let res = await db.collection('comments').doc('comment-id').update({
  rating: dbCmd.remove()
})


// 更新前
{
  "_id": "comment-id",
  "rating": 5,
  "comment": "xxx"
}

// 更新后
{
  "_id": "comment-id",
  "comment": "xxx"
}

push

向数组尾部追加元素，支持传入单个元素或数组

const dbCmd = db.command

let res = await db.collection('comments').doc('comment-id').update({
  // users: dbCmd.push('aaa')
  users: dbCmd.push(['c', 'd'])
})


// 更新前
{
  "_id": "comment-id",
  "users": ["a","b"]
}

// 更新后
{
  "_id": "comment-id",
  "users": ["a","b","c","d"]
}

pop

删除数组尾部元素

const dbCmd = db.command

let res = await db.collection('comments').doc('comment-id').update({
  users: dbCmd.pop()
})

复制代码

// 更新前
{
  "_id": "comment-id",
  "users": ["a","b"]
}

// 更新后
{
  "_id": "comment-id",
  "users": ["a"]
}

复制代码

#unshift

向数组头部添加元素，支持传入单个元素或数组。使用同push

const dbCmd = db.command

let res = await db.collection('comments').doc('comment-id').update({
  // users: dbCmd.push('aaa')
  users: dbCmd.unshift(['c', 'd'])
})

复制代码

// 更新前
{
  "_id": "comment-id",
  "users": ["a","b"]
}

// 更新后
{
  "_id": "comment-id",
  "users": ["c","d","a","b"]
}

shift

删除数组头部元素。使用同pop

const dbCmd = db.command

let res = await db.collection('comments').doc('comment-id').update({
  users: dbCmd.shift()
})

// 更新前
{
  "_id": "comment-id",
  "users": ["a","b"]
}

// 更新后
{
  "_id": "comment-id",
  "users": ["b"]
}

删除文档

方式1 通过指定文档ID删除

collection.doc(_id).remove()

// 清理全部数据
let res = await collection.get()
res.data.map(async(document) => {
  return await collection.doc(document.id).remove();
});

方式2 条件查找文档然后直接批量删除

collection.where().remove()

// 删除字段a的值大于2的文档
const dbCmd = db.command
let res = await collection.where({
  a: dbCmd.gt(2)
}).remove()

// 清理全部数据
const dbCmd = db.command
let res = await collection.where({
  _id: dbCmd.exists(true)
}).remove()

响应参数

字段类型必填说明
deletedNumber否删除的记录数量

示例：判断删除成功或失败，打印删除的记录数量

const db = uniCloud.database();
db.collection("table1").doc("5f79fdb337d16d0001899566").remove()
	.then((res) => {
		console.log("删除成功，删除条数为: ",res.deleted);
	})
	.catch((err) => {
		console.log( err.message )
	})
	.finally(() => {

	})

 本地函数与云函数的区别

本地开发的云函数, 点击uniCloud-cloudfunctions,右键上传所有云函数...
在H5控制台,可以选择使用本地云函数,还是云端云函数

删除了本地云函数,或者换了电脑.可以点击uniCloud-cloudfunctions,右键下载所有云函数
打开云web控制台,可以在 "云函数 列表" 中找到所有上传的云函数

注意: 不要在云端云函数调试代码.

分类: uniCloud

前端 贾公子
关注
专栏目录
uniCloud - 云数据库 - 更新文档 - update 更新操作符
qq_25906119的博客
02-07 1040
uniCloud 云数据库 update 更新操作符
unicloud连接云数据库，从数据库获取数据
qq_37455326的博客
01-09 679
这是调用云函数的方法。
4.6 数据库的更新和查找｜uniCloud 云开发的基础用法｜uni-app & uniCloud 从零入门开发《IT技术资讯类跨端应用》项目实战
08-31
4.6_数据库的更新和查找｜uniCloud_云开发的基础用法｜uni-app_&_uniCloud_从零入门开发《IT技术资讯
uniCloud 云数据库（新建表、增、删、改、查）
朝阳39的博客
01-03 1903
todo 为自定义的表名表结构描述文件的默认后缀为。
uniCloud 云数据库 - 更新文档 - update
qq_25906119的博客
02-07 363
uniCloud update更新云数据库
uin app 使用 uniCloud 更新APP
生命不止摸鱼不止
05-28 898
#前置要求：注册uniCloud账号； 1.创建云服务空间 2.从这个链接uniCloudAPP升级插件地址导入到云服务空间中 3.创建db_init.json，打开 4.将红圈部分复制到db_init.json中 5.在App.vue onLaunch 中加入下面这段代码 6.此时打正式包，将包下载下来后，如果可以，放到自己的服务器上，放个链接出来，粘贴到【附2】的位置或者上传到 7. 右键 db_init.json 初始化云数据库 8.将这个地址粘贴到【附2】的位置 今天刚试出来的
unicloud对接mysql_uniCloud 根据数据库生成crud云函数与管理后台crud
weixin_33479446的博客
01-30 1419
准备工作1.去uniCloud官网 注册云开发。。估计来看我的基本都有了我就一笔带过了。2.把我上面地址代码clone下来。app放进hbuilderx(app开发版)里面然后选择你的云函数，然后在cloudfunction右键选择，上传所有云函数和公共模块，在db_init.json 右键初始化云数据库上传.png初始化数据库3.在clone下来的代码打开控制台，先注册一个账号。uni-id 不...
uniCloud - 传统方式操作云数据库
qq_25906119的博客
02-07 429
uniCloud 传统方式操作云数据库
js连接unicloud云数据库
07-28
你可以使用uni-app框架提供的uniCloud插件来连接unicloud云数据库。下面是连接unicloud云数据库的基本步骤： 1. 在uni-app项目中安装uniCloud插件。可以通过以下命令使用npm进行安装： ```bash npm install @...
js获取unicloud云数据库
07-28
要使用 JavaScript 获取 unicloud 云数据库，你可以使用 uniCloud 的 JavaScript SDK。以下是获取 unicloud 云数据库的一些基本步骤： 1. 在你的项目中引入 uniCloud SDK： ```javascript import uniCloud from '...
uniCloud - 云数据库 - 更新文档 - update 与 set 的区别
qq_25906119的博客
02-07 1527
uniCloud 修改云数据库 update局部修改， set 覆盖修改的使用区别
unicloud update 修改
JiuMeilove的博客
03-14 1271
使用腾讯云时更新方法必须搭配doc、where方法使用，db.collection(‘test’).update()会报如下错误：param should have required property ‘query’未使用set、remove更新操作符的情况下，此方法不会删除字段，仅将更新数据和已有数据合并。其中,data参数是需要更新对象的属性对象,更新成功后返回更新成功条数，数据更新前后没变化时会返回0。
unicloud初级入门08-更新操作upate
虾米大王的学习历程
12-25 464
【代码】unicloud初级入门08-更新操作upate。
uniapp uniCloud云开发
最新发布
southone_problem
06-26 385
uniCloud 是 DCloud 联合阿里云、腾讯云、支付宝云，为开发者提供的基于 serverless 模式和 js 编程的云开发平台。uniCloud 的 web控制台地址：https://unicloud.dcloud.net.cn文档：https://doc.dcloud.net.cn/uniCloud/
23.uniCloud使用事务的备忘录
endingCode
10-19 289
uniCloud开启事务
uniCloud 云函数操作云数据库
m0_52223449的博客
10-26 4377
uniCloud 云函数操作云数据库
uniCloud 聚合操作实现使用值为数组字段进行联表查询
weixin_48974073的博客
01-26 1331
【代码】uniCloud 聚合操作实现使用值为数组字段进行联表查询。
uniCloud云函数中通过传统方式操作数据库的-增删改查
weixin_52479803的博客
03-10 1776
uniCloud云函数中通过传统方式操作数据库的-增删改查
uniapp热更新详细流程（App端）
二锅头
06-12 3656
将你写的云函数上传部署，如图右键，上传所有云函数（不然打包成app后，app无法使用该云函数，也就监测不到版本是否更新）最后，要更新版本时，在数据库中改新包的链接和版本号，再次登录app，即可监测到版本更新。当然，你也可自行创作开发个版本管理平台。祝，顺利。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值