diff --git a/zh-cn/application-dev/database/database-relational-guidelines.md b/zh-cn/application-dev/database/database-relational-guidelines.md
index 337ea8bc4794673fee06acac2bde4d05bf0d8952..9773137e8d8ef032789bd28f0ff786b3e76acbef 100644
--- a/zh-cn/application-dev/database/database-relational-guidelines.md
+++ b/zh-cn/application-dev/database/database-relational-guidelines.md
@@ -17,10 +17,10 @@
| 接口名 | 描述 |
| -------- | -------- |
-|getRdbStore(config: StoreConfig, version: number, callback: AsyncCallback<RdbStore>): void | 获得一个相关的RdbStore,操作关系型数据库,用户可以根据自己的需求配置RdbStore的参数,然后通过RdbStore调用相关接口可以执行相关的数据操作,结果以callback形式返回。
- config:与此RDB存储相关的数据库配置。
- version:数据库版本。
- callback:指定callback回调函数。返回一个RdbStore。 |
-|getRdbStore(config: StoreConfig, version: number): Promise<RdbStore> | 获得一个相关的RdbStore,操作关系型数据库,用户可以根据自己的需求配置RdbStore的参数,然后通过RdbStore调用相关接口可以执行相关的数据操作,结果以Promise形式返回。
- config:与此RDB存储相关的数据库配置。
- version:数据库版本。 |
-|deleteRdbStore(name: string, callback: AsyncCallback<void>): void | 删除数据库,结果以callback形式返回。
- name:数据库名称。
- callback:指定callback回调函数。 |
-| deleteRdbStore(name: string): Promise<void> | 使用指定的数据库文件配置删除数据库,结果以Promise形式返回。
- name:数据库名称。 |
+|getRdbStore(context: Context, config: StoreConfig, version: number, callback: AsyncCallback<RdbStore>): void| 获得一个相关的RdbStore,操作关系型数据库,用户可以根据自己的需求配置RdbStore的参数,然后通过RdbStore调用相关接口可以执行相关的数据操作,结果以callback形式返回。
- context:应用程序或功能的上下文。
- config:与此RDB存储相关的数据库配置。
- version:数据库版本。
- callback:指定callback回调函数。返回一个RdbStore。 |
+|getRdbStore(context: Context, config: StoreConfig, version: number): Promise<RdbStore> | 获得一个相关的RdbStore,操作关系型数据库,用户可以根据自己的需求配置RdbStore的参数,然后通过RdbStore调用相关接口可以执行相关的数据操作,结果以Promise形式返回。
- context:应用程序或功能的上下文。
- config:与此RDB存储相关的数据库配置。
- version:数据库版本。 |
+|deleteRdbStore(context: Context, name: string, callback: AsyncCallback<void> ): void | 删除数据库,结果以callback形式返回。
- context:应用程序或功能的上下文。
- name:数据库名称。
- callback:指定callback回调函数。 |
+| deleteRdbStore(context: Context, name: string): Promise<void> | 使用指定的数据库文件配置删除数据库,结果以Promise形式返回。
- context:应用程序或功能的上下文。
- name:数据库名称。 |
### 数据库的增删改查
@@ -213,9 +213,12 @@
## 开发步骤
1. 创建数据库。
- 1. 配置数据库相关信息,包括数据库的名称、存储模式、是否为只读模式等。
- 2. 初始化数据库表结构和相关数据。
- 3. 创建数据库。
+
+ (1) 配置数据库相关信息,包括数据库的名称、存储模式、是否为只读模式等。
+
+ (2) 初始化数据库表结构和相关数据。
+
+ (3) 创建数据库。
示例代码如下:
@@ -224,15 +227,17 @@
const CREATE_TABLE_TEST = "CREATE TABLE IF NOT EXISTS test (" + "id INTEGER PRIMARY KEY AUTOINCREMENT, " + "name TEXT NOT NULL, " + "age INTEGER, " + "salary REAL, " + "blobType BLOB)";
const STORE_CONFIG = {name: "rdbstore.db",}
- data_rdb.getRdbStore(STORE_CONFIG, 1, function (err, rdbStore) {
+ data_rdb.getRdbStore(this.context, STORE_CONFIG, 1, function (err, rdbStore) {
rdbStore.executeSql(CREATE_TABLE_TEST)
console.info('create table done.')
})
```
2. 插入数据。
- 1. 构造要插入的数据,以ValuesBucket形式存储。
- 2. 调用关系型数据库提供的插入接口。
+
+ (1) 构造要插入的数据,以ValuesBucket形式存储。
+
+ (2) 调用关系型数据库提供的插入接口。
示例代码如下:
@@ -243,9 +248,12 @@
```
3. 查询数据。
- 1. 构造用于查询的谓词对象,设置查询条件。
- 2. 调用查询接口查询数据。
- 3. 调用结果集接口,返回查询结果。
+
+ (1) 构造用于查询的谓词对象,设置查询条件。
+
+ (2) 调用查询接口查询数据。
+
+ (3) 调用结果集接口,返回查询结果。
示例代码如下:
@@ -265,17 +273,21 @@
```
4. 设置分布式同步表。
-
- 1.权限配置文件中增加以下配置:
+
+ (1) 权限配置文件中增加以下配置。
+
```js
"requestPermissions":
{
"name": "ohos.permission.DISTRIBUTED_DATASYNC"
}
```
- 2. 获取应用权限。
- 3. 数据库调用接口设置分布式同步列表。
- 4. 判断是否设置成功。
+
+ (2) 获取应用权限。
+
+ (3) 数据库调用接口设置分布式同步列表。
+
+ (4) 判断是否设置成功。
示例代码如下:
@@ -293,9 +305,12 @@
```
5. 分布式数据同步。
- 1. 构造用于同步分布式表的谓词对象,指定组网内的远程设备。
- 2. 调用同步数据的接口 。
- 3. 判断数据同步是否成功。
+
+ (1) 构造用于同步分布式表的谓词对象,指定组网内的远程设备。
+
+ (2) 调用同步数据的接口。
+
+ (3) 判断数据同步是否成功。
示例代码如下:
@@ -314,8 +329,10 @@
```
6. 分布式数据订阅。
- 1. 调用分布式数据订阅接口,注册数据库的观察者。
- 2. 当分布式数据库中的数据发生更改时,将调用回调。
+
+ (1) 调用分布式数据订阅接口,注册数据库的观察者。
+
+ (2) 当分布式数据库中的数据发生更改时,将调用回调。
示例代码如下:
@@ -333,8 +350,10 @@
```
7. 跨设备查询。
- 1. 根据本地表名获取指定远程设备的分布式表名。
- 2. 调用结果集接口,返回查询结果。
+
+ (1) 根据本地表名获取指定远程设备的分布式表名。
+
+ (2) 调用结果集接口,返回查询结果。
示例代码如下:
@@ -342,9 +361,12 @@
let tableName = rdbStore.obtainDistributedTableName(deviceId, "test");
let resultSet = rdbStore.querySql("SELECT * FROM " + tableName)
```
+
8. 数据库的备份和恢复。
- 1. 调用数据库的备份接口,备份当前数据库文件。
- 2. 调用数据库的恢复接口,从数据库的备份文件恢复数据库文件。
+
+ (1) 调用数据库的备份接口,备份当前数据库文件。
+
+ (2) 调用数据库的恢复接口,从数据库的备份文件恢复数据库文件。
示例代码如下: