Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
8703f026
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
8703f026
编写于
5月 24, 2022
作者:
W
wuyongning
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Add refrence of dataShare interfaces
Signed-off-by:
N
wuyongning
<
wuyongning@huawei.com
>
上级
1c66b4fe
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
214 addition
and
20 deletion
+214
-20
zh-cn/application-dev/reference/apis/js-apis-data-rdb.md
zh-cn/application-dev/reference/apis/js-apis-data-rdb.md
+214
-20
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-data-rdb.md
浏览文件 @
8703f026
...
...
@@ -1064,7 +1064,7 @@ predicates.notIn("NAME", ["Lisa", "Rose"])
### insert
insert(
nam
e: string, values: ValuesBucket, callback: AsyncCallback
<
number
>
):void
insert(
tabl
e: string, values: ValuesBucket, callback: AsyncCallback
<
number
>
):void
向目标表中插入一行数据,结果以callback形式返回。
...
...
@@ -1073,7 +1073,7 @@ insert(name: string, values: ValuesBucket, callback: AsyncCallback<number>
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
|
nam
e | string | 是 | 指定的目标表名。 |
|
tabl
e | string | 是 | 指定的目标表名。 |
| values |
[
ValuesBucket
](
#valuesbucket
)
| 是 | 表示要插入到表中的数据行。 |
| callback | AsyncCallback
<
number
>
| 是 | 指定callback回调函数。如果操作成功,返回行ID;否则返回-1。 |
...
...
@@ -1097,7 +1097,7 @@ rdbStore.insert("EMPLOYEE", valueBucket, function (err, ret) {
### insert
insert(
nam
e: string, values: ValuesBucket):Promise
<
number
>
insert(
tabl
e: string, values: ValuesBucket):Promise
<
number
>
向目标表中插入一行数据,结果以Promise形式返回。
...
...
@@ -1106,7 +1106,7 @@ insert(name: string, values: ValuesBucket):Promise<number>
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
|
nam
e | string | 是 | 指定的目标表名。 |
|
tabl
e | string | 是 | 指定的目标表名。 |
| values |
[
ValuesBucket
](
#valuesbucket
)
| 是 | 表示要插入到表中的数据行。 |
**返回值**
:
...
...
@@ -1133,7 +1133,7 @@ promise.then(async (ret) => {
### update
update(values: ValuesBucket,
rdbP
redicates: RdbPredicates, callback: AsyncCallback
<
number
>
):void
update(values: ValuesBucket,
p
redicates: RdbPredicates, callback: AsyncCallback
<
number
>
):void
根据RdbPredicates的指定实例对象更新数据库中的数据,结果以callback形式返回。
...
...
@@ -1142,8 +1142,8 @@ update(values: ValuesBucket, rdbPredicates: RdbPredicates, callback: AsyncCallba
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| values |
[
ValuesBucket
](
#valuesbucket
)
| 是 | value指示数据库中要更新的数据行。键值对与数据库表的列名相关联 |
|
rdbPredicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | 表示要插入到表中的数据行
。 |
| values |
[
ValuesBucket
](
#valuesbucket
)
| 是 | value
s
指示数据库中要更新的数据行。键值对与数据库表的列名相关联 |
|
predicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | 表示关系型数据库(RDB)的谓词指定的更新条件
。 |
| callback | AsyncCallback
<
number
>
| 是 | 指定的callback回调方法。返回受影响的行数。 |
**示例:**
...
...
@@ -1168,7 +1168,7 @@ rdbStore.update(valueBucket, predicates, function (err, ret) {
### update
update(values: ValuesBucket,
rdbP
redicates: RdbPredicates):Promise
<
number
>
update(values: ValuesBucket,
p
redicates: RdbPredicates):Promise
<
number
>
根据RdbPredicates的指定实例对象更新数据库中的数据,结果以Promise形式返回。
...
...
@@ -1177,8 +1177,8 @@ update(values: ValuesBucket, rdbPredicates: RdbPredicates):Promise<number>
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| values |
[
ValuesBucket
](
#valuesbucket
)
| 是 | value指示数据库中要更新的数据行。键值对与数据库表的列名相关联 |
|
rdbPredicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | 表示要插入到表中的数据行
。 |
| values |
[
ValuesBucket
](
#valuesbucket
)
| 是 | value
s
指示数据库中要更新的数据行。键值对与数据库表的列名相关联 |
|
predicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | 表示关系型数据库(RDB)的谓词指定的更新条件
。 |
**返回值**
:
| 类型 | 说明 |
...
...
@@ -1203,20 +1203,92 @@ promise.then(async (ret) => {
})
```
### update<sup>9+</sup>
update(table: string, values: ValuesBucket, predicates: DataSharePredicates, callback: AsyncCallback
<
number
>
):void
根据DataSharePredicates的指定实例对象更新数据库中的数据,结果以callback形式返回。
**系统能力:**
SystemCapability.DistributedDataManager.RelationalStore.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| table | string | 是 | 指定的目标表名。 |
| values |
[
ValuesBucket
](
#valuesbucket
)
| 是 | values指示数据库中要更新的数据行。键值对与数据库表的列名相关联 |
| predicates |
[
DataSharePredicates
](
#
)
| 是 | 表示DataShare的谓词指定的更新条件。 |
| callback | AsyncCallback
<
number
>
| 是 | 指定的callback回调方法。返回受影响的行数。 |
**示例:**
```
js
import
dataShare
from
'
@ohos.data.dataShare
'
const
valueBucket
=
{
"
NAME
"
:
"
Rose
"
,
"
AGE
"
:
22
,
"
SALARY
"
:
200.5
,
"
CODES
"
:
new
Uint8Array
([
1
,
2
,
3
,
4
,
5
]),
}
let
predicates
=
new
dataShare
.
DataSharePredicates
()
predicates
.
equalTo
(
"
NAME
"
,
"
Lisa
"
)
rdbStore
.
update
(
"
EMPLOYEE
"
,
valueBucket
,
predicates
,
function
(
err
,
ret
)
{
if
(
err
)
{
console
.
info
(
"
Updated failed, err:
"
+
err
)
return
}
console
.
log
(
"
Updated row count:
"
+
ret
)
})
```
### update<sup>9+</sup>
update(table: string, values: ValuesBucket, predicates: DataSharePredicates):Promise
<
number
>
根据DataSharePredicates的指定实例对象更新数据库中的数据,结果以Promise形式返回。
**系统能力:**
SystemCapability.DistributedDataManager.RelationalStore.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| table | string | 是 | 指定的目标表名。 |
| values |
[
ValuesBucket
](
#valuesbucket
)
| 是 | values指示数据库中要更新的数据行。键值对与数据库表的列名相关联 |
| predicates |
[
DataSharePredicates
](
#
)
| 是 | 表示DataShare的谓词指定的更新条件。 |
**返回值**
:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 指定的Promise回调方法。返回受影响的行数。 |
**示例:**
```
js
import
dataShare
from
'
@ohos.data.dataShare
'
const
valueBucket
=
{
"
NAME
"
:
"
Rose
"
,
"
AGE
"
:
22
,
"
SALARY
"
:
200.5
,
"
CODES
"
:
new
Uint8Array
([
1
,
2
,
3
,
4
,
5
]),
}
let
predicates
=
new
dataShare
.
DataSharePredicates
()
predicates
.
equalTo
(
"
NAME
"
,
"
Lisa
"
)
let
promise
=
rdbStore
.
update
(
"
EMPLOYEE
"
,
valueBucket
,
predicates
)
promise
.
then
(
async
(
ret
)
=>
{
console
.
log
(
"
Updated row count:
"
+
ret
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Updated failed, err:
"
+
err
)
})
```
### delete
delete(
rdbP
redicates: RdbPredicates, callback: AsyncCallback
<
number
>
):void
delete(
p
redicates: RdbPredicates, callback: AsyncCallback
<
number
>
):void
根据
r
dbPredicates的指定实例对象从数据库中删除数据,结果以callback形式返回。
根据
R
dbPredicates的指定实例对象从数据库中删除数据,结果以callback形式返回。
**系统能力:**
SystemCapability.DistributedDataManager.RelationalStore.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
|
rdbP
redicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | RdbPredicates的实例对象指定的删除条件。 |
|
p
redicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | RdbPredicates的实例对象指定的删除条件。 |
| callback | AsyncCallback
<
number
>
| 是 | 指定callback回调函数。返回受影响的行数。 |
**示例:**
...
...
@@ -1235,16 +1307,16 @@ rdbStore.delete(predicates, function (err, rows) {
### delete
delete(
rdbP
redicates: RdbPredicates):Promise
<
number
>
delete(
p
redicates: RdbPredicates):Promise
<
number
>
根据
r
dbPredicates的指定实例对象从数据库中删除数据,结果以Promise形式返回。
根据
R
dbPredicates的指定实例对象从数据库中删除数据,结果以Promise形式返回。
**系统能力:**
SystemCapability.DistributedDataManager.RelationalStore.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
|
rdbP
redicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | RdbPredicates的实例对象指定的删除条件。 |
|
p
redicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | RdbPredicates的实例对象指定的删除条件。 |
**返回值**
:
| 类型 | 说明 |
...
...
@@ -1263,10 +1335,70 @@ promise.then((rows) => {
})
```
### delete<sup>9+</sup>
delete(table: string, predicates: DataSharePredicates, callback: AsyncCallback
<
number
>
):void
根据DataSharePredicates的指定实例对象从数据库中删除数据,结果以callback形式返回。
**系统能力:**
SystemCapability.DistributedDataManager.RelationalStore.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| table | string | 是 | 指定的目标表名。 |
| predicates |
[
DataSharePredicates
](
#
)
| 是 | DataSharePredicates的实例对象指定的删除条件。 |
| callback | AsyncCallback
<
number
>
| 是 | 指定callback回调函数。返回受影响的行数。 |
**示例:**
```
js
import
dataShare
from
'
@ohos.data.dataShare
'
let
predicates
=
new
dataShare
.
DataSharePredicates
()
predicates
.
equalTo
(
"
NAME
"
,
"
Lisa
"
)
rdbStore
.
delete
(
"
EMPLOYEE
"
,
predicates
,
function
(
err
,
rows
)
{
if
(
err
)
{
console
.
info
(
"
Delete failed, err:
"
+
err
)
return
}
console
.
log
(
"
Delete rows:
"
+
rows
)
})
```
### delete<sup>9+</sup>
delete(table: string, predicates: DataSharePredicates):Promise
<
number
>
根据DataSharePredicates的指定实例对象从数据库中删除数据,结果以Promise形式返回。
**系统能力:**
SystemCapability.DistributedDataManager.RelationalStore.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| table | string | 是 | 指定的目标表名。 |
| predicates |
[
DataSharePredicates
](
#
)
| 是 | DataSharePredicates的实例对象指定的删除条件。 |
**返回值**
:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 指定Promise回调函数。返回受影响的行数。 |
**示例:**
```
js
import
dataShare
from
'
@ohos.data.dataShare
'
let
predicates
=
new
dataShare
.
DataSharePredicates
()
predicates
.
equalTo
(
"
NAME
"
,
"
Lisa
"
)
let
promise
=
rdbStore
.
delete
(
"
EMPLOYEE
"
,
predicates
)
promise
.
then
((
rows
)
=>
{
console
.
log
(
"
Delete rows:
"
+
rows
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Delete failed, err:
"
+
err
)
})
```
### query
query(
rdbP
redicates: RdbPredicates, columns: Array
<
string
>
, callback: AsyncCallback
<
ResultSet
>
):void
query(
p
redicates: RdbPredicates, columns: Array
<
string
>
, callback: AsyncCallback
<
ResultSet
>
):void
根据指定条件查询数据库中的数据,结果以callback形式返回。
...
...
@@ -1275,7 +1407,7 @@ query(rdbPredicates: RdbPredicates, columns: Array<string>, callback: Asyn
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
|
rdbP
redicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | 表示rdbPredicates的实例对象指定的查询条件。 |
|
p
redicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | 表示rdbPredicates的实例对象指定的查询条件。 |
| columns | Array
<
string
>
| 是 | 表示要查询的列。如果值为空,则查询应用于所有列。 |
| callback | AsyncCallback
<
[ResultSet](js-apis-data-resultset.md)
>
| 是 | 指定callback回调函数。如果操作成功,则返回ResultSet对象。 |
...
...
@@ -1296,7 +1428,7 @@ rdbStore.query(predicates, ["ID", "NAME", "AGE", "SALARY", "CODES"], function (e
### query
query(
rdbP
redicates: RdbPredicates, columns?: Array
<
string
>
):Promise
<
ResultSet
>
query(
p
redicates: RdbPredicates, columns?: Array
<
string
>
):Promise
<
ResultSet
>
根据指定条件查询数据库中的数据,结果以Promise形式返回。
...
...
@@ -1305,7 +1437,7 @@ query(rdbPredicates: RdbPredicates, columns?: Array<string>):Promise<Re
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
|
rdbP
redicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | 表示rdbPredicates的实例对象指定的查询条件。 |
|
p
redicates |
[
RdbPredicates
](
#rdbpredicates
)
| 是 | 表示rdbPredicates的实例对象指定的查询条件。 |
| columns | Array
<
string
>
| 否 | 表示要查询的列。如果值为空,则查询应用于所有列。 |
**返回值**
:
...
...
@@ -1326,6 +1458,68 @@ query(rdbPredicates: RdbPredicates, columns?: Array<string>):Promise<Re
})
```
### query<sup>9+</sup>
query(predicates: DataSharePredicates, columns: Array
<
string
>
, callback: AsyncCallback
<
ResultSet
>
):void
根据指定条件查询数据库中的数据,结果以callback形式返回。
**系统能力:**
SystemCapability.DistributedDataManager.RelationalStore.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| predicates |
[
DataSharePredicates
](
#
)
| 是 | 表示DataSharePredicates的实例对象指定的查询条件。 |
| columns | Array
<
string
>
| 是 | 表示要查询的列。如果值为空,则查询应用于所有列。 |
| callback | AsyncCallback
<
[ResultSet](js-apis-data-resultset.md)
>
| 是 | 指定callback回调函数。如果操作成功,则返回ResultSet对象。 |
**示例:**
```
js
import
dataShare
from
'
@ohos.data.dataShare
'
let
predicates
=
new
dataShare
.
DataSharePredicates
()
predicates
.
equalTo
(
"
NAME
"
,
"
Rose
"
)
rdbStore
.
query
(
"
EMPLOYEE
"
,
predicates
,
[
"
ID
"
,
"
NAME
"
,
"
AGE
"
,
"
SALARY
"
,
"
CODES
"
],
function
(
err
,
resultSet
)
{
if
(
err
)
{
console
.
info
(
"
Query failed, err:
"
+
err
)
return
}
console
.
log
(
"
resultSet column names:
"
+
resultSet
.
columnNames
)
console
.
log
(
"
resultSet column count:
"
+
resultSet
.
columnCount
)
})
```
### query<sup>9+</sup>
query(rdbPredicates: RdbPredicates, columns?: Array
<
string
>
):Promise
<
ResultSet
>
根据指定条件查询数据库中的数据,结果以Promise形式返回。
**系统能力:**
SystemCapability.DistributedDataManager.RelationalStore.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| rdbPredicates |
[
DataSharePredicates
](
#
)
| 是 | 表示DataSharePredicates的实例对象指定的查询条件。 |
| columns | Array
<
string
>
| 否 | 表示要查询的列。如果值为空,则查询应用于所有列。 |
**返回值**
:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
[ResultSet](js-apis-data-resultset.md)
>
| 指定Promise回调函数。如果操作成功,则返回ResultSet对象。 |
**示例:**
```
js
import
dataShare
from
'
@ohos.data.dataShare
'
let
predicates
=
new
dataShare
.
DataSharePredicates
()
predicates
.
equalTo
(
"
NAME
"
,
"
Rose
"
)
let
promise
=
rdbStore
.
query
(
"
EMPLOYEE
"
,
predicates
,
[
"
ID
"
,
"
NAME
"
,
"
AGE
"
,
"
SALARY
"
,
"
CODES
"
])
promise
.
then
((
resultSet
)
=>
{
console
.
log
(
"
resultSet column names:
"
+
resultSet
.
columnNames
)
console
.
log
(
"
resultSet column count:
"
+
resultSet
.
columnCount
)
}).
catch
((
err
)
=>
{
console
.
info
(
"
Query failed, err:
"
+
err
)
})
```
### querySql<sup>8+</sup>
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录