未验证 提交 fac1d2b6 编写于 作者: O openharmony_ci 提交者: Gitee

!9712 修改数据管理子系统部分接口描述

Merge pull request !9712 from 牛东尧/master
......@@ -32,7 +32,7 @@ DataShare即数据共享模块,用于应用管理其自身数据,也提供
- **谓词**
用户访问数据库中的数据所使用的筛选条件,经常被应用在更新数据、删除数据和查询数据等场景。
用户访问数据库中的数据所使用的筛选条件,经常被应用在更新数据、删除数据和查询数据等场景。
## 运作机制
......@@ -51,4 +51,4 @@ DataShare即数据共享模块,用于应用管理其自身数据,也提供
- DataShare受到数据提供方所使用数据库的一些限制。例如支持的数据模型、Key的长度、Value的长度、每个应用程序支持同时打开数据库的最大数量等,都会受到使用的数据库的限制。
- 因DataShare内部实现依赖于IPC通信,所以数据集、谓词、结果集等的载荷受到IPC通信的约束与限制。
- 因DataShare内部实现依赖于IPC通信,所以数据集、谓词、结果集等的载荷受到IPC通信的约束与限制。
\ No newline at end of file
# 数据共享谓词
**谓词(DataSharePredicates)** 是用户通过DataShare查询数据库中的数据所使用的筛选条件,经常被应用在更新数据([update](js-apis-data-dataShare.md#update))、删除数据([delete](js-apis-data-dataShare.md#delete))和查询数据([query](js-apis-data-dataShare.md#query))中。
**谓词(DataSharePredicates)** 是开发者通过DataShare查询数据库中的数据所使用的筛选条件,经常被应用在更新数据([update](js-apis-data-dataShare.md#update))、删除数据([delete](js-apis-data-dataShare.md#delete))和查询数据([query](js-apis-data-dataShare.md#query))中。
谓词的接口函数与数据库的筛选条件一一对应,开发者在使用前需了解数据库相关知识。
> **说明:**
>
......@@ -336,7 +338,7 @@ predicates.isNotNull("NAME")
like(field: string, value: string): DataSharePredicates
该接口用于配置谓词以匹配值类似于指定字符串的字段。
该接口用于配置谓词以匹配指定通配符表达式的字段。
目前仅RDB及KVDB(schema)支持该谓词。
......@@ -347,7 +349,7 @@ like(field: string, value: string): DataSharePredicates
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------------- |
| field | string | 是 | 数据库表中的列名。 |
| value | string | 是 | 指示要与谓词匹配的值。 |
| value | string | 是 | 指示要与谓词匹配的通配符表达式。 <br>表达式中'%'代表零个、一个或多个数字或字符,'_'代表一个单一的数字或字符,不区分大小写。|
**返回值:**
......@@ -366,7 +368,7 @@ predicates.like("NAME", "%os%")
unlike(field: string, value: string): DataSharePredicates
该接口用于配置谓词以匹配值不类似于指定字符串的字段。
该接口用于配置谓词以匹配不类似指定通配符表达式的字段。
目前仅RDB及KVDB(schema)支持该谓词。
......@@ -377,7 +379,7 @@ unlike(field: string, value: string): DataSharePredicates
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------------- |
| field | string | 是 | 数据库表中的列名。 |
| value | string | 是 | 指示要与谓词匹配的。 |
| value | string | 是 | 指示要与谓词匹配的通配符表达式。<br>表达式中'%'代表零个、一个或多个数字或字符,'_'代表一个单一的数字或字符,不区分大小写。 |
**返回值:**
......@@ -396,7 +398,7 @@ predicates.unlike("NAME", "%os%")
glob(field: string, value: string): DataSharePredicates
该接口用于配置谓词匹配数据类型为string的指定字段。
该接口用于配置谓词以匹配指定通配符表达式的字段。
目前仅RDB支持该谓词。
......@@ -407,7 +409,7 @@ glob(field: string, value: string): DataSharePredicates
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------------- |
| field | string | 是 | 数据库表中的列名。 |
| value | string | 是 | 指示要与谓词匹配的值。 |
| value | string | 是 | 指示要与谓词匹配的通配符表达式。<br>表达式中'*'代表零个、一个或多个数字或字符,'?'代表一个单一的数字或字符,区分大小写。|
**返回值:**
......@@ -426,7 +428,7 @@ predicates.glob("NAME", "?h*g")
between(field: string, low: ValueType, high: ValueType): DataSharePredicates
该接口用于配置谓词以匹配值在指定范围内的字段。
该接口用于配置谓词以匹配值在指定范围内的字段。包含两端边界值,为左闭右闭区间。
目前仅RDB支持该谓词。
......@@ -457,7 +459,7 @@ predicates.between("AGE", 10, 50)
notBetween(field: string, low: ValueType, high: ValueType): DataSharePredicates
该接口用于配置谓词以匹配值超出指定范围的字段。
该接口用于配置谓词以匹配值超出指定范围的字段。不包含两端边界值,为左开右开区间。
目前仅RDB支持该谓词。
......@@ -889,4 +891,4 @@ inKeys(keys: Array&lt;string&gt;): DataSharePredicates
```ts
let predicates = new dataSharePredicates.DataSharePredicates()
predicates.inKeys(["Lisa", "Rose"])
```
```
\ No newline at end of file
......@@ -37,8 +37,11 @@
```
distributeddatamgr/ # 子系统目录
├── appdatamgr # 本地数据管理组件目录
└── distributeddatamgr # 分布式数据服务组件目录
├── relational_store # 关系型数据库目录
└── kv_store # Key-Value数据库目录
└── data_object # 分布式数据对象目录
└── preferences # 首选项目录
└── data_share # 数据共享目录
third_party/ # 开源软件目录
├── flatbuffers # flatbuffers代码目录
......@@ -99,11 +102,16 @@ third_party/ # 开源软件目录
分布式数据管理子系统
[distributeddatamgr\_appdatamgr](https://gitee.com/openharmony/distributeddatamgr_appdatamgr)
[distributeddatamgr\_relational_store](https://gitee.com/openharmony/distributeddatamgr_relational_store)
[distributeddatamgr\_distributeddatamgr](https://gitee.com/openharmony/distributeddatamgr_datamgr)
[distributeddatamgr\_kv_store](https://gitee.com/openharmony/distributeddatamgr_kv_store)
[third\_party\_sqlite](https://gitee.com/openharmony/third_party_sqlite)
[distributeddatamgr\_data_object](https://gitee.com/openharmony/distributeddatamgr_data_object)
[distributeddatamgr\_preferences](https://gitee.com/openharmony/distributeddatamgr_preferences)
[third\_party\_flatbuffers](https://gitee.com/openharmony/third_party_flatbuffers)
[distributeddatamgr\_data_share](https://gitee.com/openharmony/distributeddatamgr_data_share)
[third\_party\_sqlite](https://gitee.com/openharmony/third_party_sqlite)
[third\_party\_flatbuffers](https://gitee.com/openharmony/third_party_flatbuffers)
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册