Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
uni-app
提交
735ceb4f
U
uni-app
项目概览
DCloud
/
uni-app
4 个月 前同步成功
通知
731
Star
38707
Fork
3642
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
7
列表
看板
标记
里程碑
合并请求
1
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
uni-app
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
7
Issue
7
列表
看板
标记
里程碑
合并请求
1
合并请求
1
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
未验证
提交
735ceb4f
编写于
9月 29, 2020
作者:
W
wanganxp
提交者:
GitHub
9月 29, 2020
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update cf-database.md
上级
c48e8710
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
26 addition
and
14 deletion
+26
-14
docs/uniCloud/cf-database.md
docs/uniCloud/cf-database.md
+26
-14
未找到文件。
docs/uniCloud/cf-database.md
浏览文件 @
735ceb4f
...
@@ -359,7 +359,7 @@ let res = await collection.doc('doc-id').set({
...
@@ -359,7 +359,7 @@ let res = await collection.doc('doc-id').set({
支持
`where()`
、
`limit()`
、
`skip()`
、
`orderBy()`
、
`get()`
、
`update()`
、
`field()`
、
`count()`
等操作。
支持
`where()`
、
`limit()`
、
`skip()`
、
`orderBy()`
、
`get()`
、
`update()`
、
`field()`
、
`count()`
等操作。
只有当调用
`get()`
`update()`
时才会真正发送
请求。
只有当调用
`get()`
、
`update()`
时才会真正发送查询
请求。
注:默认取前100条数据,最大取前100条数据。
注:默认取前100条数据,最大取前100条数据。
**get响应参数**
**get响应参数**
...
@@ -396,7 +396,12 @@ db.collection('goods').where({
...
@@ -396,7 +396,12 @@ db.collection('goods').where({
})
})
```
```
`where`
可以使用正则表达式来查询文档,比如一下示例查询所有
`name`
字段以ABC开头的用户
在SQL里使用字符串表达式操作。但在NOSQL中使用json操作。这使得 等于 的表达,从
`=`
变成了
`:`
;而大于的表达,从
`>`
变成了
`dbCmd.gt()`
所有的比较符,详见
[
表格
](
https://uniapp.dcloud.io/uniCloud/cf-database?id=%e6%9f%a5%e8%af%a2%e7%ad%9b%e9%80%89%e6%8c%87%e4%bb%a4-query-command
)
`where`
还可以使用正则表达式来查询文档,比如一下示例查询所有
`name`
字段以ABC开头的用户
```
js
```
js
db
.
collection
(
'
user
'
).
where
({
db
.
collection
(
'
user
'
).
where
({
name
:
new
RegExp
(
'
^ABC
'
)
name
:
new
RegExp
(
'
^ABC
'
)
...
@@ -443,12 +448,12 @@ collection.limit()
...
@@ -443,12 +448,12 @@ collection.limit()
| 参数 | 类型 | 必填 | 说明 |
| 参数 | 类型 | 必填 | 说明 |
| ----- | ------- | ---- | -------------- |
| ----- | ------- | ---- | -------------- |
| value | Integer | 是 |
限制展示的数值
|
| value | Integer | 是 |
返回的数据条数
|
使用示例
使用示例
```
js
```
js
let
res
=
await
collection
.
limit
(
1
).
get
()
let
res
=
await
collection
.
limit
(
1
).
get
()
// 只返回第一条记录
```
```
### 设置起始位置
### 设置起始位置
...
@@ -459,7 +464,7 @@ collection.skip()
...
@@ -459,7 +464,7 @@ collection.skip()
| 参数 | 类型 | 必填 | 说明 |
| 参数 | 类型 | 必填 | 说明 |
| ----- | ------- | ---- | -------------- |
| ----- | ------- | ---- | -------------- |
| value | Integer | 是 | 跳过
展示的
数据 |
| value | Integer | 是 | 跳过
指定的位置,从位置之后返回
数据 |
使用示例
使用示例
...
@@ -493,7 +498,7 @@ let res = await collection.orderBy("name", "asc").get()
...
@@ -493,7 +498,7 @@ let res = await collection.orderBy("name", "asc").get()
collection.field()
collection.field()
从查询结果
集
中,过滤掉不需要的字段,或者指定要返回的字段。
从查询结果中,过滤掉不需要的字段,或者指定要返回的字段。
参数说明
参数说明
...
@@ -509,11 +514,18 @@ collection.field({ 'age': true }) //只返回age字段,其他字段不返回
...
@@ -509,11 +514,18 @@ collection.field({ 'age': true }) //只返回age字段,其他字段不返回
备注:只能指定要返回的字段或者不要返回的字段。即{'a': true, 'b': false}是一种错误的参数格式
备注:只能指定要返回的字段或者不要返回的字段。即{'a': true, 'b': false}是一种错误的参数格式
### 查询指令
### 查询指令
#### eq
查询指令以dbCmd.开头,包括等于、不等于、大于、大于等于、小于、小于等于、in、nin、and、or。
#### eq 等于
表示字段等于某个值。
`eq`
指令接受一个字面量 (literal),可以是
`number`
,
`boolean`
,
`string`
,
`object`
,
`array`
。
表示字段等于某个值。
`eq`
指令接受一个字面量 (literal),可以是
`number`
,
`boolean`
,
`string`
,
`object`
,
`array`
。
比如筛选出所有自己发表的文章,除了用传对象的方式:
事实上在uniCloud的数据库中,
`等于`
有两种写法。
比如筛选出所有自己发表的文章,
写法1:使用
`:`
来比较
```
js
```
js
const
myOpenID
=
"
xxx
"
const
myOpenID
=
"
xxx
"
...
@@ -522,7 +534,7 @@ let res = await db.collection('articles').where({
...
@@ -522,7 +534,7 @@ let res = await db.collection('articles').where({
}).
get
()
}).
get
()
```
```
还可以用指令:
写法2:使用指令
`dbcmd.eq()`
```
js
```
js
const
dbCmd
=
db
.
command
const
dbCmd
=
db
.
command
...
@@ -532,7 +544,7 @@ let res = await db.collection('articles').where({
...
@@ -532,7 +544,7 @@ let res = await db.collection('articles').where({
}).
get
()
}).
get
()
```
```
注意
`eq`
指令
比对象的方式
有更大的灵活性,可以用于表示字段等于某个对象的情况,比如:
注意
`eq`
指令有更大的灵活性,可以用于表示字段等于某个对象的情况,比如:
```
js
```
js
// 这种写法表示匹配 stat.publishYear == 2018 且 stat.language == 'zh-CN'
// 这种写法表示匹配 stat.publishYear == 2018 且 stat.language == 'zh-CN'
...
@@ -1013,11 +1025,11 @@ let res = await db.collection('photo').doc('doc-id').update({
...
@@ -1013,11 +1025,11 @@ let res = await db.collection('photo').doc('doc-id').update({
更新指令。用于指示字段自增某个值,这是个原子操作,使用这个操作指令而不是先读数据、再加、再写回的好处是:
更新指令。用于指示字段自增某个值,这是个原子操作,使用这个操作指令而不是先读数据、再加、再写回的好处是:
1.
原子性:多个用户同时写,对数据库来说都是将字段加一,不会有后来者覆写前者的情况
1.
原子性:多个用户同时写,对数据库来说都是将字段加一,不会有后来者覆写前者的情况
2.
减少一次
网络
请求:不需先读再写
2.
减少一次请求:不需先读再写
之后的 mul 指令同理。
之后的 mul 指令同理。
如给收藏的商品数量加一:
在文章阅读数+1、收藏+1等很多场景会用到它。
如给收藏的商品数量加一:
```
js
```
js
const
dbCmd
=
db
.
command
const
dbCmd
=
db
.
command
...
@@ -1053,7 +1065,7 @@ let res = await db.collection('user').where({
...
@@ -1053,7 +1065,7 @@ let res = await db.collection('user').where({
}
}
```
```
请注意并没有
提供减法操作,如果要实现减法,也需
通过inc实现。比如上述字段减1,
请注意并没有
直接提供减法操作符,如果要实现减法,仍
通过inc实现。比如上述字段减1,
```
js
```
js
const
dbCmd
=
db
.
command
const
dbCmd
=
db
.
command
...
@@ -1107,7 +1119,7 @@ let res = await db.collection('user').where({
...
@@ -1107,7 +1119,7 @@ let res = await db.collection('user').where({
}
}
```
```
请注意
并没有提供除法操作,如果要实现除法,也需
通过mul实现。比如上述字段除以10,
请注意
没有直接提供除法操作符,如果要实现除法,仍
通过mul实现。比如上述字段除以10,
```
js
```
js
const
dbCmd
=
db
.
command
const
dbCmd
=
db
.
command
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录