# 查询、更新数组/嵌套对象
我们可以对对象、对象中的元素、数组、数组中的元素进行匹配查询,甚至还可以对数组和对象相互嵌套的字段进行匹配查询/更新,下面我们从普通匹配开始讲讲如何进行匹配。
# 普通匹配
传入的对象的每个 <key, value>
构成一个筛选条件,有多个 <key, value>
则表示需同时满足这些条件,是与
的关系,如果需要或
关系,可使用 [command.or]((Command.or))
比如找出未完成的进度 50 的待办事项:
db.collection('todos').where({
done: false,
progress: 50
}).get()
# 匹配记录中的嵌套字段
假设在集合中有如下一个记录:
{
"style": {
"color": "red"
}
}
如果我们想要找出集合中 style.color
为 red
的记录,那么可以传入相同结构的对象做查询条件或使用 ”点表示法“ 查询:
// 方式一
db.collection('todos').where({
style: {
color: 'red'
}
}).get()
// 方式二
db.collection('todos').where({
'style.color': 'red'
}).get()
# 匹配数组
# 匹配数组
假设在集合中有如下一个记录:
{
"numbers": [10, 20, 30]
}
可以传入一个完全相同的数组来筛选出这条记录:
db.collection('todos').where({
numbers: [10, 20, 30]
}).get()
# 匹配数组中的元素
如果想找出数组字段中数组值包含某个值的记录,那可以在匹配数组字段时传入想要匹配的值。如对上面的例子,可传入一个数组中存在的元素来筛选出所有 numbers
字段的值包含 20 的记录:
db.collection('todos').where({
numbers: 20
}).get()
# 匹配数组第 n 项元素
如果想找出数组字段中数组的第 n 个元素等于某个值的记录,那在 <key, value>
匹配中可以以 字段.下标
为 key
,目标值为 value
来做匹配。如对上面的例子,如果想找出 number
字段第二项的值为 20 的记录,可以如下查询(注意:数组下标从 0 开始):
db.collection('todos').where({
'numbers.1': 20
}).get()
更新也是类似,比如我们要更新 _id
为 test
的记录的 numbers
字段的第二项元素至 30:
db.collection('todos').doc('test').update({
data: {
'numbers.1': 30
},
})
# 结合查询指令进行匹配
在对数组字段进行匹配时,也可以使用如 lt
, gt
等指令,来筛选出字段数组中存在满足给定比较条件的记录。如对上面的例子,可查找出所有 numbers
字段的数组值中存在包含大于 25 的值的记录:
const _ = db.command
db.collection('todos').where({
numbers: _.gt(25)
}).get()
查询指令也可以通过逻辑指令组合条件,比如找出所有 numbers
数组中存在包含大于 25 的值、同时也存在小于 15 的值的记录:
const _ = db.command
db.collection('todos').where({
numbers: _.gt(25).and(_.lt(15))
}).get()
# 匹配并更新数组中的元素
如果想要匹配并更新数组中的元素,而不是替换整个数组,除了指定数组下标外,还可以:
1. 更新数组中第一个匹配到的元素
更新数组字段的时候可以用 字段路径.$
的表示法来更新数组字段的第一个满足查询匹配条件的元素。注意使用这种更新时,查询条件必须包含该数组字段。
假如有如下记录:
{
"_id": "doc1",
"scores": [10, 20, 30]
}
{
"_id": "doc2",
"scores": [20, 20, 40]
}
让所有 scores
中的第一个 20 的元素更新为 25:
// 注意:批量更新需在云函数中进行
const _ = db.command
db.collection('todos').where({
scores: 20
}).update({
data: {
'scores.$': 25
}
})
如果记录是对象数组的话也可以做到,路径如 字段路径.$.字段路径
。
注意事项:
- 不支持用在数组嵌套数组
- 如果用
unset
更新操作符,不会从数组中去除该元素,而是置为 null - 如果数组元素不是对象、且查询条件用了
neq
、not
或nin
,则不能使用$
2. 更新数组中所有匹配的元素
更新数组字段的时候可以用 字段路径.$[]
的表示法来更新数组字段的所有元素。
假如有如下记录:
{
"_id": "doc1",
"scores": {
"math": [10, 20, 30]
}
}
比如让 scores.math
字段所有数字加 10:
const _ = db.command
db.collection('todos').doc('doc1').update({
data: {
'scores.math.$[]': _.inc(10)
}
})
更新后 scores.math
数组从 [10, 20, 30]
变为 [20, 30, 40]
。
如果数组是对象数组也是可以的,假如有如下记录:
{
"_id": "doc1",
"scores": {
"math": [
{ "examId": 1, "score": 10 },
{ "examId": 2, "score": 20 },
{ "examId": 3, "score": 30 }
]
}
}
可以更新 scores.math
下各个元素的 score
原子自增 10:
const _ = db.command
db.collection('todos').doc('doc1').update({
data: {
'scores.math.$[].score': _.inc(10)
}
})
# 匹配多重嵌套的数组和对象
上面所讲述的所有规则都可以嵌套使用的,假设我们在集合中有如下一个记录:
{
"root": {
"objects": [
{
"numbers": [10, 20, 30]
},
{
"numbers": [50, 60, 70]
}
]
}
}
我们可以如下找出集合中所有的满足 root.objects 字段数组的第二项的 numbers 字段的第三项等于 70
的记录:
db.collection('todos').where({
'root.objects.1.numbers.2': 70
}).get()
注意,指定下标不是必须的,比如可以如下找出集合中所有的满足 root.objects 字段数组中任意一项的 numbers 字段包含 30
的记录:
db.collection('todos').where({
'root.objects.numbers': 30
}).get()
更新操作也是类似,比如我们要更新 _id
为 test
的 root.objects 字段数组的第二项的 numbers 字段的第三项
为 80:
db.collection('todos').doc('test').update({
data: {
'root.objects.1.numbers.2': 80
},
})