!17450 [翻译完成】#I6TFA7

Merge pull request !17450 from Annie_wang/PR16955

!17450 [翻译完成】#I6TFA7
Merge pull request !17450 from Annie_wang/PR16955
7541083e · openharmony_ci · Gitee · 46f3a6fe · 140884a6 · 7541083e
隐藏空白更改
内联并排

Showing with 43 addition and 35 deletion

en/application-dev/reference/apis/js-apis-data-relationalStore.md ...cation-dev/reference/apis/js-apis-data-relationalStore.md +43 -35

未找到文件。
--- a/en/application-dev/reference/apis/js-apis-data-relationalStore.md
+++ b/en/application-dev/reference/apis/js-apis-data-relationalStore.md
 # @ohos.data.relationalStore (RDB Store)

-The relational database (RDB) store manages data based on relational models. With the underlying SQLite database, the RDB store provides a complete mechanism for managing local databases. To satisfy different needs in complicated scenarios, the RDB store offers a series of APIs for performing operations such as adding, deleting, modifying, and querying data, and supports direct execution of SQL statements.
+The relational database (RDB) store manages data based on relational models. With the underlying SQLite database, the RDB store provides a complete mechanism for managing local databases. To satisfy different needs in complicated scenarios, the RDB store offers a series of APIs for performing operations such as adding, deleting, modifying, and querying data, and supports direct execution of SQL statements. The worker threads are not supported.

 The **relationalStore** module provides the following functions:

@@ -317,6 +317,10 @@ Defines the RDB store configuration.

 Enumerates the RDB store security levels.

+> **NOTE**
+>
+> To perform data synchronization operations, the RDB store security level must be lower than or equal to that of the peer device. For details, see the [Cross-Device Data Synchronization Mechanism](../../database/sync-app-data-across-devices-overview.md#cross-device-data-synchronization-mechanism).
+
 **System capability**: SystemCapability.DistributedDataManager.RelationalStore.Core

 | Name| Value  | Description                                                        |
@@ -424,6 +428,7 @@ Sets an **RdbPredicates** to specify the remote devices to connect on the networ
 ```js
 import deviceManager from '@ohos.distributedHardware.deviceManager';
 let dmInstance = null;
+let deviceIds = [];

 deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager) => {
    if (err) {
@@ -432,7 +437,6 @@ deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager)
    }
    dmInstance = manager;
    let devices = dmInstance.getTrustedDeviceListSync();
-    let deviceIds = [];
    for (var i = 0; i < devices.length; i++) {
        deviceIds[i] = devices[i].deviceId;
    }
@@ -1231,7 +1235,7 @@ predicates.notIn("NAME", ["Lisa", "Rose"]);

 Provides methods to manage an RDB store.

-Before using the following APIs, use [executeSql](#executesql) to initialize the database table structure and related data. For details, see [RDB Development](../../database/database-relational-guidelines.md).
+Before using the APIs of this class, use [executeSql](#executesql) to initialize the database table structure and related data.

 ### insert

@@ -1868,6 +1872,7 @@ Queries data from the RDB store of a remote device based on specified conditions
 ```js
 import deviceManager from '@ohos.distributedHardware.deviceManager';
 let dmInstance = null;
+let deviceId = null;

 deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager) => {
    if (err) {
@@ -1876,7 +1881,7 @@ deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager)
    }
    dmInstance = manager;
    let devices = dmInstance.getTrustedDeviceListSync();
-    let deviceId = devices[0].deviceId;
+    deviceId = devices[0].deviceId;
 })

 let predicates = new relationalStore.RdbPredicates('EMPLOYEE');
@@ -1925,6 +1930,7 @@ Queries data from the RDB store of a remote device based on specified conditions
 ```js
 import deviceManager from '@ohos.distributedHardware.deviceManager';
 let dmInstance = null;
+let deviceId = null;

 deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager) => {
    if (err) {
@@ -1933,12 +1939,12 @@ deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager)
    }
    dmInstance = manager;
    let devices = dmInstance.getTrustedDeviceListSync();
-    let deviceId = devices[0].deviceId;
+    deviceId = devices[0].deviceId;
 })

 let predicates = new relationalStore.RdbPredicates('EMPLOYEE');
 predicates.greaterThan("id", 0);
-let promise = store.remoteQuery("deviceId", "EMPLOYEE", predicates, ["ID", "NAME", "AGE", "SALARY", "CODES"]);
+let promise = store.remoteQuery(deviceId, "EMPLOYEE", predicates, ["ID", "NAME", "AGE", "SALARY", "CODES"]);
 promise.then((resultSet) => {
  console.info(`ResultSet column names: ${resultSet.columnNames}`);
  console.info(`ResultSet column count: ${resultSet.columnCount}`);
@@ -1957,11 +1963,11 @@ Queries data using the specified SQL statement. This API uses an asynchronous ca

 **Parameters**

-| Name  | Type                                                        | Mandatory| Description                                                       |
-| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------------- |
-| sql      | string                                                       | Yes  | SQL statement to run.                                      |
-| bindArgs | Array&lt;[ValueType](#valuetype)&gt;                         | Yes  | Arguments in the SQL statement.                                        |
-| callback | AsyncCallback&lt;[ResultSet](#resultset)&gt; | Yes  | Callback invoked to return the result. If the operation is successful, a **ResultSet** object will be returned.|
+| Name  | Type                                        | Mandatory| Description                                                        |
+| -------- | -------------------------------------------- | ---- | ------------------------------------------------------------ |
+| sql      | string                                       | Yes  | SQL statement to run.                                       |
+| bindArgs | Array&lt;[ValueType](#valuetype)&gt;         | Yes  | Arguments in the SQL statement. The value corresponds to the placeholders in the SQL parameter statement. If the SQL parameter statement is complete, the value of this parameter must be an empty array.|
+| callback | AsyncCallback&lt;[ResultSet](#resultset)&gt; | Yes  | Callback invoked to return the result. If the operation is successful, a **ResultSet** object will be returned.   |

 **Example**

@@ -1986,10 +1992,10 @@ Queries data using the specified SQL statement. This API uses a promise to retur

 **Parameters**

-| Name  | Type                                | Mandatory| Description                 |
-| -------- | ------------------------------------ | ---- | --------------------- |
-| sql      | string                               | Yes  | SQL statement to run.|
-| bindArgs | Array&lt;[ValueType](#valuetype)&gt; | No  | Arguments in the SQL statement.  |
+| Name  | Type                                | Mandatory| Description                                                        |
+| -------- | ------------------------------------ | ---- | ------------------------------------------------------------ |
+| sql      | string                               | Yes  | SQL statement to run.                                       |
+| bindArgs | Array&lt;[ValueType](#valuetype)&gt; | No  | Arguments in the SQL statement. The value corresponds to the placeholders in the SQL parameter statement. If the SQL parameter statement is complete, leave this parameter blank.|

 **Return value**

@@ -2000,7 +2006,7 @@ Queries data using the specified SQL statement. This API uses a promise to retur
 **Example**

 ```js
-let promise = store.querySql("SELECT * FROM EMPLOYEE CROSS JOIN BOOK WHERE BOOK.NAME = ?", ['sanguo']);
+let promise = store.querySql("SELECT * FROM EMPLOYEE CROSS JOIN BOOK WHERE BOOK.NAME = 'sanguo'");
 promise.then((resultSet) => {
  console.info(`ResultSet column names: ${resultSet.columnNames}`);
  console.info(`ResultSet column count: ${resultSet.columnCount}`);
@@ -2019,22 +2025,22 @@ Executes an SQL statement that contains specified arguments but returns no value

 **Parameters**

-| Name  | Type                                | Mandatory| Description                  |
-| -------- | ------------------------------------ | ---- | ---------------------- |
-| sql      | string                               | Yes  | SQL statement to run. |
-| bindArgs | Array&lt;[ValueType](#valuetype)&gt; | Yes  | Arguments in the SQL statement.   |
-| callback | AsyncCallback&lt;void&gt;            | Yes  | Callback invoked to return the result.|
+| Name  | Type                                | Mandatory| Description                                                        |
+| -------- | ------------------------------------ | ---- | ------------------------------------------------------------ |
+| sql      | string                               | Yes  | SQL statement to run.                                       |
+| bindArgs | Array&lt;[ValueType](#valuetype)&gt; | Yes  | Arguments in the SQL statement. The value corresponds to the placeholders in the SQL parameter statement. If the SQL parameter statement is complete, the value of this parameter must be an empty array.|
+| callback | AsyncCallback&lt;void&gt;            | Yes  | Callback invoked to return the result.                                      |

 **Example**

 ```js
-const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)"
-store.executeSql(SQL_CREATE_TABLE, null, function(err) {
+const SQL_DELETE_TABLE = "DELETE FROM test WHERE name = ?"
+store.executeSql(SQL_DELETE_TABLE, ['zhangsan'], function(err) {
  if (err) {
    console.error(`ExecuteSql failed, err: ${err}`);
    return;
  }
-  console.info(`Create table done.`);
+  console.info(`Delete table done.`);
 })
 ```

@@ -2048,10 +2054,10 @@ Executes an SQL statement that contains specified arguments but returns no value

 **Parameters**

-| Name  | Type                                | Mandatory| Description                 |
-| -------- | ------------------------------------ | ---- | --------------------- |
-| sql      | string                               | Yes  | SQL statement to run.|
-| bindArgs | Array&lt;[ValueType](#valuetype)&gt; | No  | Arguments in the SQL statement.  |
+| Name  | Type                                | Mandatory| Description                                                        |
+| -------- | ------------------------------------ | ---- | ------------------------------------------------------------ |
+| sql      | string                               | Yes  | SQL statement to run.                                       |
+| bindArgs | Array&lt;[ValueType](#valuetype)&gt; | No  | Arguments in the SQL statement. The value corresponds to the placeholders in the SQL parameter statement. If the SQL parameter statement is complete, leave this parameter blank.|

 **Return value**

@@ -2062,10 +2068,10 @@ Executes an SQL statement that contains specified arguments but returns no value
 **Example**

 ```js
-const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)"
-let promise = store.executeSql(SQL_CREATE_TABLE);
+const SQL_DELETE_TABLE = "DELETE FROM test WHERE name = 'zhangsan'"
+let promise = store.executeSql(SQL_DELETE_TABLE);
 promise.then(() => {
-    console.info(`Create table done.`);
+    console.info(`Delete table done.`);
 }).catch((err) => {
    console.error(`ExecuteSql failed, err: ${err}`);
 })
@@ -2384,6 +2390,7 @@ Obtains the distributed table name of a remote device based on the local table n
 ```js
 import deviceManager from '@ohos.distributedHardware.deviceManager';
 let dmInstance = null;
+let deviceId = null;

 deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager) => {
    if (err) {
@@ -2392,7 +2399,7 @@ deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager)
    }
    dmInstance = manager;
    let devices = dmInstance.getTrustedDeviceListSync();
-    let deviceId = devices[0].deviceId;
+    deviceId = devices[0].deviceId;
 })

 store.obtainDistributedTableName(deviceId, "EMPLOYEE", function (err, tableName) {
@@ -2436,6 +2443,7 @@ Obtains the distributed table name of a remote device based on the local table n
 ```js
 import deviceManager from '@ohos.distributedHardware.deviceManager';
 let dmInstance = null;
+let deviceId = null;

 deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager) => {
    if (err) {
@@ -2444,7 +2452,7 @@ deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager)
    }
    dmInstance = manager;
    let devices = dmInstance.getTrustedDeviceListSync();
-    let deviceId = devices[0].deviceId;
+    deviceId = devices[0].deviceId;
 })

 let promise = store.obtainDistributedTableName(deviceId, "EMPLOYEE");
@@ -2478,6 +2486,7 @@ Synchronizes data between devices. This API uses an asynchronous callback to ret
 ```js
 import deviceManager from '@ohos.distributedHardware.deviceManager';
 let dmInstance = null;
+let deviceIds = [];

 deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager) => {
    if (err) {
@@ -2486,7 +2495,6 @@ deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager)
    }
    dmInstance = manager;
    let devices = dmInstance.getTrustedDeviceListSync();
-    let deviceIds = [];
    for (var i = 0; i < devices.length; i++) {
        deviceIds[i] = devices[i].deviceId;
    }
@@ -2534,6 +2542,7 @@ Synchronizes data between devices. This API uses a promise to return the result.
 ```js
 import deviceManager from '@ohos.distributedHardware.deviceManager';
 let dmInstance = null;
+let deviceIds = [];

 deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager) => {
    if (err) {
@@ -2542,7 +2551,6 @@ deviceManager.createDeviceManager("com.example.appdatamgrverify", (err, manager)
    }
    dmInstance = manager;
    let devices = dmInstance.getTrustedDeviceListSync();
-    let deviceIds = [];
    for (var i = 0; i < devices.length; i++) {
        deviceIds[i] = devices[i].deviceId;
    }