diff --git a/zh-cn/application-dev/reference/apis/js-apis-data-rdb.md b/zh-cn/application-dev/reference/apis/js-apis-data-rdb.md index 11be31f50c4f6bb6024d52d05fb75019f122c13c..25f14e4a81f0bb850165164857fd4353e20452d2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-data-rdb.md +++ b/zh-cn/application-dev/reference/apis/js-apis-data-rdb.md @@ -1057,7 +1057,7 @@ query(rdbPredicates: RdbPredicates, columns: Array<string>, callback: Asyn ### query -query(rdbPredicates: RdbPredicates, columns: Array<string>):Promise<ResultSet> +query(rdbPredicates: RdbPredicates, columns?: Array<string>):Promise<ResultSet> 根据指定条件查询数据库中的数据,结果以Promise形式返回。 @@ -1065,7 +1065,7 @@ query(rdbPredicates: RdbPredicates, columns: Array<string>):Promise<Res | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | rdbPredicates | [RdbPredicates](#rdbpredicates) | 是 | 表示rdbPredicates的实例对象指定的查询条件。 | - | columns | Array<string> | 是 | 表示要查询的列。如果值为空,则查询应用于所有列。 | + | columns | Array<string> | 否 | 表示要查询的列。如果值为空,则查询应用于所有列。 | - 返回值: | 类型 | 说明 | @@ -1083,6 +1083,53 @@ query(rdbPredicates: RdbPredicates, columns: Array<string>):Promise<Res ``` +### querySql8+ + +querySql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallback<ResultSet>):void + +根据指定SQL语句查询数据库中的数据,结果以callback形式返回。 + +- 参数: + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | sql | string | 是 | 指定要执行的SQL语句。 | + | bindArgs | Array<[ValueType](#valuetype)> | 是 | SQL语句中参数的值。 | + | callback | AsyncCallback<[ResultSet](js-apis-data-resultset.md)> | 是 | 指定callback回调函数。如果操作成功,则返回ResultSet对象。 | + +- 示例: + ``` + rdbStore.querySql("SELECT * FROM EMPLOYEE CROSS JOIN BOOK WHERE BOOK.NAME = ?", ['sanguo'], function (err, resultSet) { + console.log(TAG + "resultSet column names:" + resultSet.columnNames) + console.log(TAG + "resultSet column count:" + resultSet.columnCount)}) + ``` + + +### querySql8+ + +querySql(sql: string, bindArgs?: Array<ValueType>):Promise<ResultSet> + +根据指定SQL语句查询数据库中的数据,结果以Promise形式返回。 + +- 参数: + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | sql | string | 是 | 指定要执行的SQL语句。 | + | bindArgs | Array<[ValueType](#valuetype)> | 否 | SQL语句中参数的值。 | + +- 返回值: + | 类型 | 说明 | + | -------- | -------- | + | Promise<[ResultSet](../apis/js-apis-data-resultset.md)> | 指定Promise回调函数。如果操作成功,则返回ResultSet对象。 | + +- 示例: + ``` + let promise = rdbStore.querySql("SELECT * FROM EMPLOYEE CROSS JOIN BOOK WHERE BOOK.NAME = ?", ['sanguo']) + promise.then((resultSet) => { + console.log(TAG + "resultSet column names:" + resultSet.columnNames) + console.log(TAG + "resultSet column count:" + resultSet.columnCount)}) + ``` + + ### executeSql executeSql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallback<void>):void @@ -1098,14 +1145,14 @@ executeSql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallbac - 示例: ``` - rdbStore.executeSql("DELETE FROM EMPLOYEE", function () { + rdbStore.executeSql("DELETE FROM EMPLOYEE", null, function () { console.info(TAG + 'delete done.')}) ``` ### executeSql -executeSql(sql: string, bindArgs: Array<ValueType>):Promise<void> +executeSql(sql: string, bindArgs?: Array<ValueType>):Promise<void> 执行包含指定参数但不返回值的SQL语句,结果以Promise形式返回。 @@ -1113,7 +1160,7 @@ executeSql(sql: string, bindArgs: Array<ValueType>):Promise<void> | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | sql | string | 是 | 指定要执行的SQL语句。 | - | bindArgs | Array<[ValueType](#valuetype)> | 是 | SQL语句中参数的值。 | + | bindArgs | Array<[ValueType](#valuetype)> | 否 | SQL语句中参数的值。 | - 返回值: | 类型 | 说明 |