!16736 RDB文档修复

Merge pull request !16736 from lihuihui/master

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

 # @ohos.data.rdb (关系型数据库)
 
-关系型数据库（Relational Database，RDB）是一种基于关系模型来管理数据的数据库。关系型数据库基于SQLite组件提供了一套完整的对本地数据库进行管理的机制，对外提供了一系列的增、删、改、查等接口，也可以直接运行用户输入的SQL语句来满足复杂的场景需要。
+关系型数据库（Relational Database，RDB）是一种基于关系模型来管理数据的数据库。关系型数据库基于SQLite组件提供了一套完整的对本地数据库进行管理的机制，对外提供了一系列的增、删、改、查等接口，也可以直接运行用户输入的SQL语句来满足复杂的场景需要。不支持Worker线程。
 
 该模块提供以下关系型数据库相关的常用功能：
 
@@ -1565,7 +1565,7 @@ querySql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallback&
 | 参数名 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
 | sql | string | 是 | 指定要执行的SQL语句。 |
-| bindArgs | Array<[ValueType](#valuetype)> | 是 | SQL语句中参数的值。 |
+| bindArgs | Array<[ValueType](#valuetype)> | 是 | SQL语句中参数的值。该值与sql参数语句中的占位符相对应。当sql参数语句完整时，该参数需为空数组。 |
 | callback | AsyncCallback<[ResultSet](js-apis-data-resultset.md)> | 是 | 指定callback回调函数。如果操作成功，则返回ResultSet对象。 |
 
 **示例：**
@@ -1594,7 +1594,7 @@ querySql(sql: string, bindArgs?: Array<ValueType>):Promise<ResultSet&gt
 | 参数名 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
 | sql | string | 是 | 指定要执行的SQL语句。 |
-| bindArgs | Array<[ValueType](#valuetype)> | 否 | SQL语句中参数的值。 |
+| bindArgs | Array<[ValueType](#valuetype)> | 否 | SQL语句中参数的值。该值与sql参数语句中的占位符相对应。当sql参数语句完整时，该参数不填。 |
 
 **返回值**：
 
@@ -1605,7 +1605,7 @@ querySql(sql: string, bindArgs?: Array<ValueType>):Promise<ResultSet&gt
 **示例：**
 
 ```js
-let promise = rdbStore.querySql("SELECT * FROM EMPLOYEE CROSS JOIN BOOK WHERE BOOK.NAME = ?", ['sanguo'])
+let promise = rdbStore.querySql("SELECT * FROM EMPLOYEE CROSS JOIN BOOK WHERE BOOK.NAME = 'sanguo'")
 promise.then((resultSet) => {
     console.log("ResultSet column names: " + resultSet.columnNames)
     console.log("ResultSet column count: " + resultSet.columnCount)
@@ -1627,19 +1627,19 @@ executeSql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallbac
 | 参数名 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
 | sql | string | 是 | 指定要执行的SQL语句。 |
-| bindArgs | Array<[ValueType](#valuetype)> | 是 | SQL语句中参数的值。 |
+| bindArgs | Array<[ValueType](#valuetype)> | 是 | SQL语句中参数的值。该值与sql参数语句中的占位符相对应。当sql参数语句完整时，该参数需为空数组。 |
 | callback | AsyncCallback<void> | 是 | 指定callback回调函数。 |
 
 **示例：**
 
 ```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)"
-rdbStore.executeSql(SQL_CREATE_TABLE, null, function(err) {
+const SQL_DELETE_TABLE = "DELETE FROM test WHERE name = ?"
+rdbStore.executeSql(SQL_CREATE_TABLE, ['zhangsan'], function(err) {
     if (err) {
         console.info("ExecuteSql failed, err: " + err)
         return
     }
-    console.info('Create table done.')
+    console.info('Delete table done.')
 })
 ```
 
@@ -1656,7 +1656,7 @@ executeSql(sql: string, bindArgs?: Array<ValueType>):Promise<void>
 | 参数名 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
 | sql | string | 是 | 指定要执行的SQL语句。 |
-| bindArgs | Array<[ValueType](#valuetype)> | 否 | SQL语句中参数的值。 |
+| bindArgs | Array<[ValueType](#valuetype)> | 否 | SQL语句中参数的值。该值与sql参数语句中的占位符相对应。当sql参数语句完整时，该参数不填。 |
 
 **返回值**：
 
@@ -1667,10 +1667,10 @@ executeSql(sql: string, bindArgs?: Array<ValueType>):Promise<void>
 **示例：**
 
 ```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 = rdbStore.executeSql(SQL_CREATE_TABLE)
+const SQL_DELETE_TABLE = "DELETE FROM test WHERE name = 'zhangsan'"
+let promise = rdbStore.executeSql(SQL_DELETE_TABLE)
 promise.then(() => {
-    console.info('Create table done.')
+    console.info('Delete table done.')
 }).catch((err) => {
     console.info("ExecuteSql failed, err: " + err)
 })

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

 # @ohos.data.relationalStore (关系型数据库)
 
-关系型数据库（Relational Database，RDB）是一种基于关系模型来管理数据的数据库。关系型数据库基于SQLite组件提供了一套完整的对本地数据库进行管理的机制，对外提供了一系列的增、删、改、查等接口，也可以直接运行用户输入的SQL语句来满足复杂的场景需要。
+关系型数据库（Relational Database，RDB）是一种基于关系模型来管理数据的数据库。关系型数据库基于SQLite组件提供了一套完整的对本地数据库进行管理的机制，对外提供了一系列的增、删、改、查等接口，也可以直接运行用户输入的SQL语句来满足复杂的场景需要。不支持Worker线程。
 
 该模块提供以下关系型数据库相关的常用功能：
 
@@ -2265,11 +2265,11 @@ querySql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallback&
 
 **参数：**
 
-| 参数名   | 类型                                                         | 必填 | 说明                                                        |
-| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------------- |
-| sql      | string                                                       | 是   | 指定要执行的SQL语句。                                       |
-| bindArgs | Array<[ValueType](#valuetype)>                         | 是   | SQL语句中参数的值。                                         |
-| callback | AsyncCallback<[ResultSet](#resultset)> | 是   | 指定callback回调函数。如果操作成功，则返回ResultSet对象。 |
+| 参数名   | 类型                                         | 必填 | 说明                                                         |
+| -------- | -------------------------------------------- | ---- | ------------------------------------------------------------ |
+| sql      | string                                       | 是   | 指定要执行的SQL语句。                                        |
+| bindArgs | Array<[ValueType](#valuetype)>         | 是   | SQL语句中参数的值。该值与sql参数语句中的占位符相对应。当sql参数语句完整时，该参数需为空数组。 |
+| callback | AsyncCallback<[ResultSet](#resultset)> | 是   | 指定callback回调函数。如果操作成功，则返回ResultSet对象。    |
 
 **示例：**
 
@@ -2294,10 +2294,10 @@ querySql(sql: string, bindArgs?: Array<ValueType>):Promise<ResultSet&gt
 
 **参数：**
 
-| 参数名   | 类型                                 | 必填 | 说明                  |
-| -------- | ------------------------------------ | ---- | --------------------- |
-| sql      | string                               | 是   | 指定要执行的SQL语句。 |
-| bindArgs | Array<[ValueType](#valuetype)> | 否   | SQL语句中参数的值。   |
+| 参数名   | 类型                                 | 必填 | 说明                                                         |
+| -------- | ------------------------------------ | ---- | ------------------------------------------------------------ |
+| sql      | string                               | 是   | 指定要执行的SQL语句。                                        |
+| bindArgs | Array<[ValueType](#valuetype)> | 否   | SQL语句中参数的值。该值与sql参数语句中的占位符相对应。当sql参数语句完整时，该参数不填。 |
 
 **返回值**：
 
@@ -2308,7 +2308,7 @@ querySql(sql: string, bindArgs?: Array<ValueType>):Promise<ResultSet&gt
 **示例：**
 
 ```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}`);
@@ -2327,11 +2327,11 @@ executeSql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallbac
 
 **参数：**
 
-| 参数名   | 类型                                 | 必填 | 说明                   |
-| -------- | ------------------------------------ | ---- | ---------------------- |
-| sql      | string                               | 是   | 指定要执行的SQL语句。  |
-| bindArgs | Array<[ValueType](#valuetype)> | 是   | SQL语句中参数的值。    |
-| callback | AsyncCallback<void>            | 是   | 指定callback回调函数。 |
+| 参数名   | 类型                                 | 必填 | 说明                                                         |
+| -------- | ------------------------------------ | ---- | ------------------------------------------------------------ |
+| sql      | string                               | 是   | 指定要执行的SQL语句。                                        |
+| bindArgs | Array<[ValueType](#valuetype)> | 是   | SQL语句中参数的值。该值与sql参数语句中的占位符相对应。当sql参数语句完整时，该参数需为空数组。 |
+| callback | AsyncCallback<void>            | 是   | 指定callback回调函数。                                       |
 
 **错误码：**
 
@@ -2344,13 +2344,13 @@ executeSql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallbac
 **示例：**
 
 ```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.`);
 })
 ```
 
@@ -2364,10 +2364,10 @@ executeSql(sql: string, bindArgs?: Array<ValueType>):Promise<void>
 
 **参数：**
 
-| 参数名   | 类型                                 | 必填 | 说明                  |
-| -------- | ------------------------------------ | ---- | --------------------- |
-| sql      | string                               | 是   | 指定要执行的SQL语句。 |
-| bindArgs | Array<[ValueType](#valuetype)> | 否   | SQL语句中参数的值。   |
+| 参数名   | 类型                                 | 必填 | 说明                                                         |
+| -------- | ------------------------------------ | ---- | ------------------------------------------------------------ |
+| sql      | string                               | 是   | 指定要执行的SQL语句。                                        |
+| bindArgs | Array<[ValueType](#valuetype)> | 否   | SQL语句中参数的值。该值与sql参数语句中的占位符相对应。当sql参数语句完整时，该参数不填。 |
 
 **返回值**：
 
@@ -2386,10 +2386,10 @@ executeSql(sql: string, bindArgs?: Array<ValueType>):Promise<void>
 **示例：**
 
 ```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}`);
 })