Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
Tonvia
Docs
提交
c65873b5
D
Docs
项目概览
Tonvia
/
Docs
与 Fork 源项目一致
Fork自
OpenHarmony / Docs
通知
1
Star
0
Fork
0
代码
文件
提交
分支
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看板
体验新版 GitCode,发现更多精彩内容 >>
提交
c65873b5
编写于
6月 20, 2022
作者:
W
wuyongning
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
修改检视问题/增加示例代码
Signed-off-by:
N
wuyongning
<
wuyongning@huawei.com
>
上级
fe4818c7
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
49 addition
and
13 deletion
+49
-13
zh-cn/application-dev/database/database-relational-guidelines.md
...pplication-dev/database/database-relational-guidelines.md
+32
-9
zh-cn/device-dev/subsystems/subsys-data-relational-database-guide.md
...e-dev/subsystems/subsys-data-relational-database-guide.md
+17
-4
未找到文件。
zh-cn/application-dev/database/database-relational-guidelines.md
浏览文件 @
c65873b5
...
...
@@ -32,8 +32,8 @@
| 类名 | 接口名 | 描述 |
| -------- | -------- | -------- |
| RdbStore | insert(
name:
string,
values:
ValuesBucket,
callback:
AsyncCallback
<
number
>
):void | 向目标表中插入一行数据,结果以callback形式返回。
<br/>
-
nam
e:指定的目标表名。
<br/>
-
values:表示要插入到表中的数据行。
<br/>
-
callback:指定callback回调函数。如果操作成功,返回行ID;否则返回-1。 |
| RdbStore | insert(
name:
string,
values:
ValuesBucket):
Promise
<
number
>
| 向目标表中插入一行数据,结果以Promise形式返回。
<br/>
-
nam
e:指定的目标表名。
<br/>
-
values:表示要插入到表中的数据行。 |
| RdbStore | insert(
table:
string,
values:
ValuesBucket,
callback:
AsyncCallback
<
number
>
):void | 向目标表中插入一行数据,结果以callback形式返回。
<br/>
-
tabl
e:指定的目标表名。
<br/>
-
values:表示要插入到表中的数据行。
<br/>
-
callback:指定callback回调函数。如果操作成功,返回行ID;否则返回-1。 |
| RdbStore | insert(
table:
string,
values:
ValuesBucket):
Promise
<
number
>
| 向目标表中插入一行数据,结果以Promise形式返回。
<br/>
-
tabl
e:指定的目标表名。
<br/>
-
values:表示要插入到表中的数据行。 |
-
**更新**
...
...
@@ -43,8 +43,8 @@
| 类名 | 接口名 | 描述 |
| -------- | -------- | -------- |
| RdbStore | update(values:
ValuesBucket,
rdbPredicates:
RdbPredicates,
callback:
AsyncCallback
<
number
>
):void | 根据RdbPredicates的指定实例对象更新数据库中的数据,结果以callback形式返回。
<br/>
-
values:以ValuesBucket存储的要更新的数据。
<br/>
-
rdbP
redicates:表示RdbPredicates的实例对象指定的更新条件。
<br/>
-
callback:指定的callback回调方法。返回受影响的行数。 |
| RdbStore | update(values:
ValuesBucket,
rdbPredicates:
RdbPredicates):
Promise
\<
number> | 根据RdbPredicates的指定实例对象更新数据库中的数据,结果以Promise形式返回。
<br/>
-
values:以ValuesBucket存储的要更新的数据。
<br/>
-
rdbP
redicates:表示RdbPredicates的实例对象指定的更新条件。 |
| RdbStore | update(values:
ValuesBucket,
predicates:
RdbPredicates,
callback:
AsyncCallback
<
number
>
):void | 根据RdbPredicates的指定实例对象更新数据库中的数据,结果以callback形式返回。
<br/>
-
values:以ValuesBucket存储的要更新的数据。
<br/>
-
p
redicates:表示RdbPredicates的实例对象指定的更新条件。
<br/>
-
callback:指定的callback回调方法。返回受影响的行数。 |
| RdbStore | update(values:
ValuesBucket,
predicates:
RdbPredicates):
Promise
<
number
>
| 根据RdbPredicates的指定实例对象更新数据库中的数据,结果以Promise形式返回。
<br/>
-
values:以ValuesBucket存储的要更新的数据。
<br/>
-
p
redicates:表示RdbPredicates的实例对象指定的更新条件。 |
-
**删除**
...
...
@@ -54,8 +54,8 @@
| 类名 | 接口名 | 描述 |
| -------- | -------- | -------- |
| RdbStore | delete(
rdbPredicates:
RdbPredicates,
callback:
AsyncCallback
<
number
>
):void | 根据rdbPredicates的指定实例对象从数据库中删除数据,结果以callback形式返回。
<br/>
-
rdbP
redicates:RdbPredicates的实例对象指定的删除条件。
<br/>
-
callback:指定callback回调函数。返回受影响的行数。 |
| RdbStore | delete(
rdbPredicates:
RdbPredicates):
Promise
\<
number> | 根据rdbPredicates的指定实例对象从数据库中删除数据,结果以Promise形式返回。
<br/>
-
rdbP
redicates:RdbPredicates的实例对象指定的删除条件。 |
| RdbStore | delete(
predicates:
RdbPredicates,
callback:
AsyncCallback
<
number
>
):void | 根据RdbPredicates的指定实例对象从数据库中删除数据,结果以callback形式返回。
<br/>
-
p
redicates:RdbPredicates的实例对象指定的删除条件。
<br/>
-
callback:指定callback回调函数。返回受影响的行数。 |
| RdbStore | delete(
predicates:
RdbPredicates):
Promise
<
number
>
| 根据RdbPredicates的指定实例对象从数据库中删除数据,结果以Promise形式返回。
<br/>
-
p
redicates:RdbPredicates的实例对象指定的删除条件。 |
-
**查询**
...
...
@@ -68,8 +68,8 @@
| 类名 | 接口名 | 描述 |
| -------- | -------- | -------- |
| RdbStore | query(
rdbPredicates:
RdbPredicates,
columns:
Array,
callback:
AsyncCallback
<
ResultSet
>
):
void | 根据指定条件查询数据库中的数据,结果以callback形式返回。
<br/>
-
rdbP
redicates:表示RdbPredicates的实例对象指定的查询条件。
<br/>
-
columns:表示要查询的列。如果值为空,则查询应用于所有列。
<br/>
-
callback:指定callback回调函数。如果操作成功,则返回ResultSet对象。 |
| RdbStore | query(
rdbPredicates:
RdbPredicates,
columns:
Array):
Promise
<
ResultSet
>
| 根据指定条件查询数据库中的数据,结果以Promise形式返回。
<br/>
-
rdbP
redicates:表示RdbPredicates的实例对象指定的查询条件。
<br/>
-
columns:表示要查询的列。如果值为空,则查询应用于所有列。 |
| RdbStore | query(
predicates:
RdbPredicates,
columns:
Array,
callback:
AsyncCallback
<
ResultSet
>
):
void | 根据指定条件查询数据库中的数据,结果以callback形式返回。
<br/>
-
p
redicates:表示RdbPredicates的实例对象指定的查询条件。
<br/>
-
columns:表示要查询的列。如果值为空,则查询应用于所有列。
<br/>
-
callback:指定callback回调函数。如果操作成功,则返回ResultSet对象。 |
| RdbStore | query(
predicates:
RdbPredicates,
columns:
Array):
Promise
<
ResultSet
>
| 根据指定条件查询数据库中的数据,结果以Promise形式返回。
<br/>
-
p
redicates:表示RdbPredicates的实例对象指定的查询条件。
<br/>
-
columns:表示要查询的列。如果值为空,则查询应用于所有列。 |
| RdbStore | querySql(sql:
string,
bindArgs:
Array
<
ValueType
>
,
callback:
AsyncCallback
<
ResultSet
>
):void | 根据指定SQL语句查询数据库中的数据,结果以callback形式返回。
<br/>
-
sql:指定要查询的SQL语句。
<br/>
-
bindArgs:SQL语句中参数的值。
<br/>
-
callback:指定callback回调函数。如果操作成功,则返回ResultSet对象。 |
| RdbStore | querySql(sql:
string,
bindArgs?:
Array
<
ValueType
>
):Promise
<
ResultSet
>
| 根据指定SQL语句查询数据库中的数据,结果以Promise形式返回。
<br/>
-
sql:指定要查询的SQL语句。
<br/>
-
bindArgs:SQL语句中参数的值。 |
...
...
@@ -201,7 +201,7 @@
**恢复**
**表1
3
**
恢复数据库
**表1
4
**
恢复数据库
| 类名 | 接口名 | 描述 |
| -------- | -------- | -------- |
...
...
@@ -340,6 +340,29 @@
let tableName = rdbStore.obtainDistributedTableName(deviceId, "test");
let resultSet = rdbStore.querySql("SELECT * FROM " + tableName)
```
8.
数据库的备份和恢复。
1.
调用数据库的备份接口,备份当前数据库文件。
2.
调用数据库的恢复接口,从数据库的备份文件恢复数据库文件。
示例代码如下:
```js
let promiseBackup = rdbStore.backup("dbBackup.db")
promiseBackup.then(()=>{
console.info('Backup success.')
}).catch((err)=>{
console.info('Backup failed, err: ' + err)
})
```
```js
let promiseRestore = rdbStore.restore("dbBackup.db")
promiseRestore.then(()=>{
console.info('Restore success.')
}).catch((err)=>{
console.info('Restore failed, err: ' + err)
})
```
## 相关实例
针对关系型数据库开发,有以下相关实例可供参考:
-
[
`Rdb`:关系型数据库(eTS)(API8)
](
https://gitee.com/openharmony/app_samples/tree/master/data/Rdb
)
...
...
zh-cn/device-dev/subsystems/subsys-data-relational-database-guide.md
浏览文件 @
c65873b5
...
...
@@ -161,23 +161,23 @@
-
备份
关系型数据库提供了备份数据库文件的接口,通过databasePath指定的备份文件名(
也可以是目录+文件名的形式
)备份当前数据库文件。通过返回值判断是否备份成功,成功时返回0,失败时则返回相应的错误码。
关系型数据库提供了备份数据库文件的接口,通过databasePath指定的备份文件名(
支持路径
)备份当前数据库文件。通过返回值判断是否备份成功,成功时返回0,失败时则返回相应的错误码。
表11 数据库备份API
| 类名 | 接口名 | 描述 |
| ---- | ---- | ---- |
| RdbStore | int Backup(const std::string databasePath, const std::vector
<uint8_t>
destEncryptKey) | 备份数据库文件。
<ul><li>
databasePath:指定的备份文件名。
</li><li>
destEncryptKey:数据库的加密密钥。注意:当前只支持非加密数据库的备份。
</li></ul>
|
| RdbStore | int Backup(const std::string databasePath, const std::vector
<
uint8_t
>
destEncryptKey) | 备份数据库文件。
<ul><li>
databasePath:指定的备份文件名。
</li><li>
destEncryptKey:数据库的加密密钥。注意:当前只支持非加密数据库的备份。
</li></ul>
|
-
恢复
关系型数据库提供了恢复数据库文件的接口,通过
databasePath指定的备份文件名(也可以是目录+文件名的形式
)恢复当前数据库文件。通过返回值判断是否恢复成功,成功时返回0,失败时则返回相应的错误码。
关系型数据库提供了恢复数据库文件的接口,通过
backupPath指定的备份文件名(支持路径
)恢复当前数据库文件。通过返回值判断是否恢复成功,成功时返回0,失败时则返回相应的错误码。
表12 数据库恢复API
| 类名 | 接口名 | 描述 |
| ---- | ---- | ---- |
| RdbStore | int Restore(const std::string backupPath, const std::vector
<uint8_t>
&newKey) | 恢复数据库文件。
<ul><li>
backupPath:指定的备份文件名。
</li><li>
newKey:数据库的加密密钥。注意:当前只支持非加密数据库的恢复。
</li></ul>
|
| RdbStore | int Restore(const std::string backupPath, const std::vector
<
uint8_t
>
&newKey) | 恢复数据库文件。
<ul><li>
backupPath:指定的备份文件名。
</li><li>
newKey:数据库的加密密钥。注意:当前只支持非加密数据库的恢复。
</li></ul>
|
## 约束与限制
...
...
@@ -327,3 +327,16 @@
std::string tableName = store->ObtainDistributedTableName("123456789abcd", "test");
auto resultSet = store->QuerySql("SELECT * from ?;", tableName);
```
8. 数据库的备份和恢复
a. 根据指定的数据库备份文件名备份当前数据库
b. 根据指定的数据库备份文件恢复当前数据库
示例代码如下:
```
std::string backupName = "backup.db";
std::vector
<uint8_t>
key;
int errno = store->Backup(backupName, key);
errno = store->Restore(backupName, key);
```
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录