!4808 【RDB】3.2Beta1接口参考文档增加权限描述

Merge pull request !4808 from Cap_W/OpenHarmony-3.2-Beta1

zh-cn/application-dev/database/database-relational-guidelines.md

@@ -141,6 +141,8 @@
 
 ### 设置分布式列表
 
+>**注意：**  在使用RdbStore的setDistributedTables、obtainDistributedTableName、sync、on、off接口时，需要请求相应的权限：ohos.permission.DISTRIBUTED_DATASYNC。
+
 **设置分布式列表**
 
 **表8** 设置分布式列表
@@ -242,19 +244,31 @@
    ```
 
 4. 设置分布式同步表。
-   1. 数据库调用接口设置分布式同步列表。
-   2. 判断是否设置成功。
+   
+    1.权限配置文件中增加以下配置：
+    ```js
+    "requestPermissions": 
+        {
+            "name": "ohos.permission.DISTRIBUTED_DATASYNC"
+        }
+    ```
+    2. 获取应用权限。
+    3. 数据库调用接口设置分布式同步列表。
+    4. 判断是否设置成功。
 
    示例代码如下：
 
-   ```js
-   let promise = rdbStore.setDistributedTables(["test"])
-   promise.then(() => {
-       console.info("setDistributedTables success.")
-   }).catch((err) => {
-       console.info("setDistributedTables failed.")
-   })
-   ```
+    ```js
+    let context = featureAbility.getContext();
+    context.requestPermissionsFromUser(['ohos.permission.DISTRIBUTED_DATASYNC'], 666, function (result) {
+        console.info(`result.requestCode=${result.requestCode}`)
+    })
+    let promise = rdbStore.setDistributedTables(["test"])
+    promise.then(() => {
+        console.info("setDistributedTables success.")
+    }).catch((err) => {
+        console.info("setDistributedTables failed.")
+    })
 
  5. 分布式数据同步。
     1. 构造用于同步分布式表的谓词对象，指定组网内的远程设备。

zh-cn/application-dev/reference/apis/js-apis-data-rdb.md

@@ -1540,6 +1540,8 @@ setDistributedTables(tables: Array<string>, callback: AsyncCallback<voi
 
 设置分布式列表，结果以callback形式返回。
 
+**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
+
 **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core。
 
 **参数：**
@@ -1566,6 +1568,8 @@ rdbStore.setDistributedTables(["EMPLOYEE"], function (err) {
 
 设置分布式列表，结果以Promise形式返回。
 
+**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
+
 **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core。
 
 **参数：**
@@ -1594,6 +1598,8 @@ obtainDistributedTableName(device: string, table: string, callback: AsyncCallbac
 
 根据本地表名获取指定远程设备的分布式表名。在查询远程设备数据库时，需要使用分布式表名, 结果以callback形式返回。
 
+**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
+
 **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core。
 
 **参数：**
@@ -1621,6 +1627,8 @@ rdbStore.obtainDistributedTableName(deviceId, "EMPLOYEE", function (err, tableNa
 
 根据本地表名获取指定远程设备的分布式表名。在查询远程设备数据库时，需要使用分布式表名，结果以Promise形式返回。
 
+**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
+
 **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core。
 
 **参数：**
@@ -1650,6 +1658,8 @@ sync(mode: SyncMode, predicates: RdbPredicates, callback: AsyncCallback<Array
 
 在设备之间同步数据, 结果以callback形式返回。
 
+**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
+
 **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core。
 
 **参数：**
@@ -1682,6 +1692,8 @@ rdbStore.sync(rdb.SyncMode.SYNC_MODE_PUSH, predicates, function (err, result) {
 
 在设备之间同步数据，结果以Promise形式返回。
 
+**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
+
 **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core。
 
 **参数：**
@@ -1717,6 +1729,8 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback<Array<stri
 
 注册数据库的观察者。当分布式数据库中的数据发生更改时，将调用回调。
 
+**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
+
 **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core。
 
 **参数：**
@@ -1747,6 +1761,8 @@ off(event:'dataChange', type: SubscribeType, observer: Callback<Array<stri
 
 从数据库中删除指定类型的指定观察者, 结果以callback形式返回。
 
+**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
+
 **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core。
 
 **参数：**
@@ -1821,6 +1837,8 @@ try {
 
 描述订阅类型。
 
+**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
+
 **系统能力：** 以下各项对应的系统能力均为SystemCapability.DistributedDataManager.RelationalStore.Core。
 
 | 名称      | 默认值 | 说明 |