From b6b8cd1f87c33869a05328c952838e5eb56ff414 Mon Sep 17 00:00:00 2001 From: wangyaqi Date: Mon, 1 Feb 2021 19:41:10 +0800 Subject: [PATCH] docs: uniCloud clientDB --- docs/uniCloud/clientdb.md | 14 +++++++------- docs/uniCloud/schema.md | 7 ++++--- 2 files changed, 11 insertions(+), 10 deletions(-) diff --git a/docs/uniCloud/clientdb.md b/docs/uniCloud/clientdb.md index 6b2528ab8..903b6037b 100644 --- a/docs/uniCloud/clientdb.md +++ b/docs/uniCloud/clientdb.md @@ -591,7 +591,7 @@ where内还支持使用云端环境变量，详情参考：[云端环境变量]( > HBuilderX 3.1.0起支持 -复杂查询对应着[聚合操作符](uniCloud/clientdb.md?id=aggregate-operator)。需要注意的是，与云函数内使用聚合操作符不同jql内对聚合操作符的用法进行了简化。 +复杂查询内可以使用[数据库运算方法](uniCloud/clientdb.md?id=aggregate-operator)。需要注意的是，与云函数内使用聚合操作符不同jql内对数据库运算方法的用法进行了简化。 例：数据表test内有以下数据 @@ -778,9 +778,9 @@ db.collection('order,book') ### 对字段操作后返回@operator -自`HBuilderX 3.1.0`起，clientDB支持对字段进行一定的操作之后再返回，详细可用的方法列表请参考：[聚合操作符](uniCloud/clientdb.md?id=aggregate-operator) +自`HBuilderX 3.1.0`起，clientDB支持对字段进行一定的操作之后再返回，详细可用的方法列表请参考：[数据库运算方法](uniCloud/clientdb.md?id=aggregate-operator) -> 需要注意的是，为方便书写，clientDB内将聚合操作符的用法进行了简化（相对于云函数内使用聚合操作符而言）。用法请参考上述链接 +> 需要注意的是，为方便书写，clientDB内将数据库运算方法的用法进行了简化（相对于云函数内使用数据库运算方法而言）。用法请参考上述链接 例：数据表class内有以下数据 @@ -1412,7 +1412,7 @@ const res = await db.collection('table1').groupBy('field1,field2').groupField('s #### 求和、求均值示例 -groupBy内也可以使用聚合操作符对数据进行处理，为方便书写，clientDB内将聚合操作符的用法进行了简化（相对于云函数内使用聚合操作符而言）。用法请参考：[聚合操作符](uniCloud/clientdb.md?id=aggregate-operator) +groupBy内也可以使用数据库运算方法对数据进行处理，为方便书写，clientDB内将数据库运算方法的用法进行了简化（相对于云函数内使用数据库运算方法而言）。用法请参考：[数据库运算方法](uniCloud/clientdb.md?id=aggregate-operator) groupField内可以使用累计器操作符对分组结果进行统计，所有可用的累计方法请参考[累计器操作符](uniCloud/clientdb.md?id=accumulator)，下面以sum（求和）和avg（求均值）为例介绍如何使用 @@ -1668,7 +1668,7 @@ res = { } ``` -完整聚合操作符列表请参考：[clientDB内可使用的聚合操作符](uniCloud/clientdb.md?id=aggregate-operator) +完整数据库运算方法列表请参考：[clientDB内可使用的数据库运算方法](uniCloud/clientdb.md?id=aggregate-operator) #### count权限控制 @@ -2556,9 +2556,9 @@ module.exports = { **如需在before和after内传参，建议直接在state上挂载。但是切勿覆盖上述属性** -## 可用聚合操作符列表@aggregate-operator +## 可用数据库运算方法列表@aggregate-operator -为方便书写，clientDB内将聚合操作符的用法进行了简化（相对于云函数内使用聚合操作符而言），主要是参数摊平。以下是可以在clientDB中使用的聚合操作符 +为方便书写，clientDB内将数据库运算方法的用法进行了简化（相对于云函数内使用数据库运算方法而言），主要是参数摊平。以下是可以在clientDB中使用的数据库运算方法 |操作符 |详细文档（云函数内用法） |JQL简化用法 |说明 | |--- |--- |--- |--- | diff --git a/docs/uniCloud/schema.md b/docs/uniCloud/schema.md index 8d2eed1b5..3d92c32c4 100644 --- a/docs/uniCloud/schema.md +++ b/docs/uniCloud/schema.md @@ -726,7 +726,7 @@ if (uni) { 自`HBuilderX 3.1.0`起，支持schema内配置一级节点fieldRules对字段之间的关系进行约束和校验。当然只校验一个字段也可以。 -fieldRules的写法等同JQL的where写法（也可以使用各种聚合操作符），参考：[clientDB where](uniCloud/clientdb.md?id=where) +fieldRules的写法等同JQL的where写法（也可以使用各种数据库运算方法），参考：[clientDB where](uniCloud/clientdb.md?id=where) fieldRules内配置如下，数组内可以配置多个rule，每个rule都有rule表达式、错误提示语、运行兼容环境这3部分。 @@ -745,8 +745,9 @@ rule表达式，是一组js，返回值必须为true或false。返回false则触 rule表达式里支持： 1. 字段名称 -2. 字段的聚合运算方法 -3. js语法和基本内置对象，一般来说仅需使用`new Date()`来获取云端的时间，暂不支持`Date.now()、Math`。需要注意的是不同于聚合运算符，js内置方法不可传入数据库字段作为参数 +2. 数据库运算方法 +3. js语法 +4. 另外还支持`new Date()`来获取时间。需要注意的是不同于数据库运算方法，`new Date()`内不可传入数据库字段作为参数 上述配置中，`end_date`为字段名称。schema内也支持写字段操作方法，如add方法。 -- GitLab