update README.md.

This commit is contained in:
moyang 2022-07-07 05:16:43 +00:00 committed by Gitee
parent ea4e21b09e
commit 66661f5433
No known key found for this signature in database
GPG Key ID: 173E9B9CA92EEF8F

View File

@ -34,6 +34,31 @@
4. [新闻系统opendb-news](opendb-news.md)
5. [日志管理opendb-log](opendb-log.md)
## 预置数据
`openDB`不仅支持定义常用的数据表字段,还可以预置初始化数据。
比如,[opendb-city-china](https://gitee.com/dcloud/opendb/tree/master/collection/opendb-city-china)是opendb中定义好的`中国城市字典表`,它的定义分为两个部分:
- collection.json定义数据表名称、所含字段、每个字段的类型以及读写权限规则等
- data.json定义初始化内容
你通过[uniCloud web控制台](https://unicloud.dcloud.net.cn)创建`openDB`表时,`uniCloud`会自动校验该opendb表定义中是否包含`data.json`,若包含,则在创建表定义后,自动导入`data.json`。
如果你的 HBuilderX 项目中,`uniCloud/database`目录下定义的数据表中含有opendb表定义则对该opendb表执行`上传DB Schema`操作时uniCloud服务端会判断该opendb表是否已存在
- 若该opendb表已存在则仅更新 `DB Schema`
- 若该opendb表不存在则先创建该表然后校验该opendb表定义中是否包含`data.json`,若包含`data.json`,则自动导入`data.json`
## 数据表升级
`openDB`数据表在后续的更新迭代中,可能会涉及到`schema`及`预置数据`的变更。自`HBuilderX 3.5.1`之后opendb表支持检查更新。
以[opendb-city-china](https://gitee.com/dcloud/opendb/tree/master/collection/opendb-city-china)为例,当我们要修改或补充城市时,为了兼容已部署的数据表,应提供差量数据,这时我们需要做的是:
- 更新 `opendb-city-china/package.json`中的`version`字段为升级后的版本号;
- 新增 `opendb-city-china/collection.update-原始版本号-升级版本号.jql` JQL数据库管理器文件内容为差量数据的JQL语句
比如行政区域的撤销或设立需要数据升级并且定义升级后的版本号为0.0.2这时需要将差量数据以JQL语句的形式写入文件`opendb-city-china/collection.update-0.0.1-0.0.2.jql`中,并更新`opendb-city-china/package.json`的`version`字段。
# 如何引入到自己的服务空间
在[uniCloud web控制台](https://unicloud.dcloud.net.cn),新建表时,可直接选择所有`openDB`的表。