Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
“f1d8c73c76306028584022e18aa9586f0a51422a”上不存在“...application-models/arkts-ui-widget-image-update.md”
提交 a3f845fe 编写于 作者: R renjiecui
浏览文件
操作

modify docs 

Signed-off-by: Nrenjiecui <cuirenjie@huawei.com>
上级 27380221
显示空白变更内容
内联 并排
Showing with 79 addition and 132 deletion
zh-cn/application-dev/reference/apis/js-apis-data-relationalStore.md
浏览文件 @ a3f845fe
...@@ -343,6 +343,9 @@ class EntryAbility extends UIAbility { ...@@ -343,6 +343,9 @@ class EntryAbility extends UIAbility {
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ------------------------------- | --- | -------------- | | ------------------------------- | --- | -------------- |
| ASSET_NORMAL | - | 表示资产状态正常。 | | ASSET_NORMAL | - | 表示资产状态正常。 |
| ASSET_INSERT | - | 表示资产需要插入到云端。 |
| ASSET_UPLOAD | - | 表示资产需要更新到云端。 |
| ASSET_DELETE | - | 表示资产需要在云端删除。 |
| ASSET_ABNORMAL | - | 表示资产状态异常。 | | ASSET_ABNORMAL | - | 表示资产状态异常。 |
| ASSET_DOWNLOADING | - | 表示资产正在下载到本地设备。 | | ASSET_DOWNLOADING | - | 表示资产正在下载到本地设备。 |
...@@ -368,7 +371,7 @@ class EntryAbility extends UIAbility { ...@@ -368,7 +371,7 @@ class EntryAbility extends UIAbility {
| 类型 | 说明 | | 类型 | 说明 |
| ------- | -------------------- | | ------- | -------------------- |
| [Asset](#asset10)[] | 表示[Asset](#asset10)类型的数组。 | | [Asset](#asset10)[] | 表示Asset类型的数组。 |
## ValueType ## ValueType
...@@ -384,7 +387,7 @@ class EntryAbility extends UIAbility { ...@@ -384,7 +387,7 @@ class EntryAbility extends UIAbility {
| boolean | 表示值类型为布尔值。 | | boolean | 表示值类型为布尔值。 |
| Uint8Array | 表示值类型为Uint8类型的数组。 | | Uint8Array | 表示值类型为Uint8类型的数组。 |
| Asset<sup>10+</sup> | 表示值类型为附件[Asset](#asset10)。 | | Asset<sup>10+</sup> | 表示值类型为附件[Asset](#asset10)。 |
| Asstes<sup>10+</sup> | 表示值类型为附件数组[Assets](#assets10)。 | | Assets<sup>10+</sup> | 表示值类型为附件数组[Assets](#assets10)。 |
## ValuesBucket ## ValuesBucket
...@@ -400,8 +403,6 @@ class EntryAbility extends UIAbility { ...@@ -400,8 +403,6 @@ class EntryAbility extends UIAbility {
指数据库同步模式。 指数据库同步模式。
**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| -------------- | ---- | ---------------------------------- | | -------------- | ---- | ---------------------------------- |
| SYNC_MODE_PUSH | 0 | 表示数据从本地设备推送到远程设备。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core | | SYNC_MODE_PUSH | 0 | 表示数据从本地设备推送到远程设备。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core |
...@@ -428,6 +429,8 @@ class EntryAbility extends UIAbility { ...@@ -428,6 +429,8 @@ class EntryAbility extends UIAbility {
**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core
**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| -------------------------- | --- | -------------------------- | | -------------------------- | --- | -------------------------- |
| DATA_CHANGE | - | 表示是数据发生变更。请使用枚举名称而非枚举值。 | | DATA_CHANGE | - | 表示是数据发生变更。请使用枚举名称而非枚举值。 |
...@@ -442,7 +445,7 @@ class EntryAbility extends UIAbility { ...@@ -442,7 +445,7 @@ class EntryAbility extends UIAbility {
| 名称 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------- | --- | -------------------------------------------------------------------------------------------------------------------- | | -------- | ---------------------------------- | --- | -------------------------------------------------------------------------------------------------------------------- |
| table | string | 是 | 表示发生变化的表的名称。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core | | table | string | 是 | 表示发生变化的表的名称。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core |
| type | [ChangeType](#changetype) | 是 | 表示发生变化的数据的类型，数据或者资产附件发生变化。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core | | type | [ChangeType](#changetype10) | 是 | 表示发生变化的数据的类型，数据或者资产附件发生变化。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core |
| inserted | Array\<string\> \| Array\<number\> | 是 | 记录插入数据的位置，如果该表的主键是string类型，该值是主键的值，否则该值表示插入数据的行号。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core | | inserted | Array\<string\> \| Array\<number\> | 是 | 记录插入数据的位置，如果该表的主键是string类型，该值是主键的值，否则该值表示插入数据的行号。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core |
| updated | Array\<string\> \| Array\<number\> | 是 | 记录更新数据的位置，如果该表的主键是string类型，该值是主键的值，否则该值表示更新数据的行号。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core | | updated | Array\<string\> \| Array\<number\> | 是 | 记录更新数据的位置，如果该表的主键是string类型，该值是主键的值，否则该值表示更新数据的行号。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core |
| deleted | Array\<string\> \| Array\<number\> | 是 | 记录删除数据的位置，如果该表的主键是string类型，该值是主键的值，否则该值表示删除数据的行号。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core | | deleted | Array\<string\> \| Array\<number\> | 是 | 记录删除数据的位置，如果该表的主键是string类型，该值是主键的值，否则该值表示删除数据的行号。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core |
...@@ -451,9 +454,11 @@ class EntryAbility extends UIAbility { ...@@ -451,9 +454,11 @@ class EntryAbility extends UIAbility {
描述表的分布式类型的枚举。 描述表的分布式类型的枚举。
**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ------------------ | --- | -------------------------------------------------------------------------------------------------- | | ------------------ | --- | -------------------------------------------------------------------------------------------------- |
| DISTRIBUTED_DEVICE | 0 | 表示表在不同设备之间分布式。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore. | | DISTRIBUTED_DEVICE | 0 | 表示表在不同设备之间分布式。<br>**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core |
| DISTRIBUTED_CLOUD | - | 表示表在设备和云端之间分布式。请使用枚举名称而非枚举值。<br>**系统能力：** SystemCapability.DistributedDataManager.CloudSync.Client | | DISTRIBUTED_CLOUD | - | 表示表在设备和云端之间分布式。请使用枚举名称而非枚举值。<br>**系统能力：** SystemCapability.DistributedDataManager.CloudSync.Client |
## DistributedConfig<sup>10+</sup> ## DistributedConfig<sup>10+</sup>
...@@ -463,8 +468,8 @@ class EntryAbility extends UIAbility { ...@@ -463,8 +468,8 @@ class EntryAbility extends UIAbility {
**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core
| 名称 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | ------- | --- | ------------------------------------------------------ | | -------- | ------- | ---- | ------------------------------------------------------------ |
| autoSync | boolean | 是 | 该值为true时，表示该表支持自动同步和手动同步；该值为false时，表示该表只支持手动同步，不支持自动同步。 | | autoSync | boolean | 是 | 该值为true时，表示该表支持自动同步和手动同步；该值为false时，表示该表只支持手动同步，不支持自动同步。<br>默认值是false。 |
## ConflictResolution<sup>10+</sup> ## ConflictResolution<sup>10+</sup>
...@@ -2960,11 +2965,11 @@ store.setDistributedTables(["EMPLOYEE"], function (err) { ...@@ -2960,11 +2965,11 @@ store.setDistributedTables(["EMPLOYEE"], function (err) {
}) })
``` ```
### setDistributedTables ### setDistributedTables<sup>10+</sup>
setDistributedTables(tables: Array&lt;string&gt;): Promise&lt;void&gt; setDistributedTables(tables: Array&lt;string&gt;, type: DistributedType, callback: AsyncCallback&lt;void&gt;): void
设置分布式列表，使用Promise异步回调。 设置分布式列表，使用callback异步回调。
**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC **需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
...@@ -2973,38 +2978,36 @@ store.setDistributedTables(["EMPLOYEE"], function (err) { ...@@ -2973,38 +2978,36 @@ store.setDistributedTables(["EMPLOYEE"], function (err) {
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------- | ---- | ------------------------ | | -------- | ------------------------------------ | ---- | ---------------------- |
| tables | Array&lt;string&gt; | 是 | 要设置的分布式列表表名。 | | tables | Array&lt;string&gt; | 是 | 要设置的分布式列表表名 |
| type | [DistributedType](distributedtype10) | 是 | 表的分布式类型。 |
**返回值**： | callback | AsyncCallback&lt;void&gt; | 是 | 指定callback回调函数。 |
| 类型 | 说明 |
| ------------------- | ------------------------- |
| Promise&lt;void&gt; | 无返回结果的Promise对象。 |
**错误码：** **错误码：**
以下错误码的详细介绍请参见[关系型数据库错误码](../errorcodes/errorcode-data-rdb.md)。 以下错误码的详细介绍请参见[关系型数据库错误码](../errorcodes/errorcode-data-rdb.md)。
| **错误码ID** | **错误信息** | | **错误码ID** | **错误信息** |
| ------------ | ---------------------------- | | ------------ | ------------ |
| 14800000 | Inner error. | | 14800000 | Inner error. |
**示例：** **示例：**
```js ```js
let promise = store.setDistributedTables(["EMPLOYEE"]); store.setDistributedTables(["EMPLOYEE"], DistributedType.DISTRIBUTED_CLOUD, function (err) {
promise.then(() => { if (err) {
console.info(`SetDistributedTables successfully.`);
}).catch((err) => {
console.error(`SetDistributedTables failed, code is ${err.code},message is ${err.message}`); console.error(`SetDistributedTables failed, code is ${err.code},message is ${err.message}`);
return;
}
console.info(`SetDistributedTables successfully.`);
}) })
``` ```
### setDistributedTables<sup>10+</sup>
setDistributedTables(tables: Array&lt;string&gt;, type: DistributedType, callback: AsyncCallback&lt;void&gt;): void ### setDistributedTables
设置分布式列表，使用callback异步回调。 setDistributedTables(*tables*: Array&lt;string>, type?: DistributedType, config?: DistributedConfig): Promise&lt;void>
设置分布式列表，使用Promise异步回调。
**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC **需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
...@@ -3013,32 +3016,42 @@ setDistributedTables(tables: Array&lt;string&gt;, type: DistributedType, callbac ...@@ -3013,32 +3016,42 @@ setDistributedTables(tables: Array&lt;string&gt;, type: DistributedType, callbac
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------- | --- | --------------- | | ------ | ----------------------------------------- | ---- | ---------------------------------------------------- |
| tables | Array&lt;string&gt; | 是 | 要设置的分布式列表表名。 | | tables | Array&lt;string&gt; | 是 | 要设置的分布式列表表名。 |
| type | [DistributedType](#distributedtype) | 是 | 表的分布式类型。 | | type | number | 否 | 表的分布式类型。<br> API version 10新增可选参数。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 指定callback回调函数。 | | config | [DistributedConfig](#distributedconfig10) | 否 | 表的分布式配置信息。<br/> API version 10新增可选参数 |
**返回值**：
| 类型 | 说明 |
| ------------------- | ------------------------- |
| Promise&lt;void&gt; | 无返回结果的Promise对象。 |
**错误码：** **错误码：**
以下错误码的详细介绍请参见[关系型数据库错误码](../errorcodes/errorcode-data-rdb.md)。 以下错误码的详细介绍请参见[关系型数据库错误码](../errorcodes/errorcode-data-rdb.md)。
| **错误码ID** | **错误信息** |
| ------------ | ---------------------------- |
| 14800000 | Inner error. |
**示例：** **示例：**
```js ```js
store.setDistributedTables(["EMPLOYEE"], DistributedType.DISTRIBUTED_CLOUD, function (err) { let config = new DistributedConfig();
if (err) { config.autoSync = true;
console.error(`SetDistributedTables failed, code is ${err.code},message is ${err.message}`); let promise = store.setDistributedTables(["EMPLOYEE"], DistributedType.DISTRIBUTED_CLOUD, config);
return; promise.then(() => {
}
console.info(`SetDistributedTables successfully.`); console.info(`SetDistributedTables successfully.`);
}).catch((err) => {
console.error(`SetDistributedTables failed, code is ${err.code},message is ${err.message}`);
}) })
``` ```
### setDistributedTables<sup>10+</sup> ### setDistributedTables<sup>10+</sup>
setDistributedTables(tables: Array&lt;string&gt;, type?: number, config?: DistributedConfig): Promise&lt;void&gt; setDistributedTables(tables: Array&lt;string&gt;, type: number, config: DistributedConfig, callback: AsyncCallback&lt;void&gt;): void
设置分布式列表，使用Promise异步回调。 设置分布式列表，使用callback异步回调。
**需要权限：** ohos.permission.DISTRIBUTED_DATASYNC **需要权限：** ohos.permission.DISTRIBUTED_DATASYNC
...@@ -3047,27 +3060,23 @@ store.setDistributedTables(["EMPLOYEE"], DistributedType.DISTRIBUTED_CLOUD, func ...@@ -3047,27 +3060,23 @@ store.setDistributedTables(["EMPLOYEE"], DistributedType.DISTRIBUTED_CLOUD, func
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | --------------------------------------- | --- | ------------ | | -------- | ----------------------------------- | --- | --------------- |
| tables | Array&lt;string&gt; | 是 | 要设置的分布式列表表名。 | | tables | Array&lt;string&gt; | 是 | 要设置的分布式列表表名。 |
| type | [DistributedType](#distributedtype) | 否 | 表的分布式类型。 | | type | number | 是 | 表的分布式类型。 |
| config | [DistributedConfig](#distributedconfig) | 否 | 表的分布式配置信息。 | | config | [DistributedConfig](#distributedconfig10) | 是 | 表的分布式配置信息。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 指定callback回调函数。 |
**返回值**：
| 类型 | 说明 |
| ------------------- | ---------------- |
| Promise&lt;void&gt; | 无返回结果的Promise对象。 |
**示例：** **示例：**
```js ```js
let config = new DistributedConfig(); let config = new DistributedConfig();
config.autoSync = true; config.autoSync = true;
let promise = store.setDistributedTables(["EMPLOYEE"], DistributedType.DISTRIBUTED_CLOUD, config); store.setDistributedTables(["EMPLOYEE"], DistributedType.DISTRIBUTED_CLOUD, config, function (err) {
promise.then(() => { if (err) {
console.info(`SetDistributedTables successfully.`);
}).catch((err) => {
console.error(`SetDistributedTables failed, code is ${err.code},message is ${err.message}`); console.error(`SetDistributedTables failed, code is ${err.code},message is ${err.message}`);
return;
}
console.info(`SetDistributedTables successfully.`);
}) })
``` ```
...@@ -3311,9 +3320,9 @@ promise.then((result) =>{ ...@@ -3311,9 +3320,9 @@ promise.then((result) =>{
### on('dataChange') ### on('dataChange')
on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;string&gt;&gt;): void on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;string&gt;&gt;\| Callback&lt;Array&lt;ChangeInfo&gt;&gt;): void
注册数据库的观察者。当分布式数据库中的数据发生更改时，将调用回调。 注册数据库的数据变更的事件监听。当分布式数据库中的数据发生更改时，将调用回调。
**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core
...@@ -3323,7 +3332,7 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;stri ...@@ -3323,7 +3332,7 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;stri
| -------- | ----------------------------------- | ---- | ------------------------------------------- | | -------- | ----------------------------------- | ---- | ------------------------------------------- |
| event | string | 是 | 取值为'dataChange'，表示数据更改。 | | event | string | 是 | 取值为'dataChange'，表示数据更改。 |
| type | [SubscribeType](#subscribetype) | 是 | 订阅类型。 | | type | [SubscribeType](#subscribetype) | 是 | 订阅类型。 |
| observer | Callback&lt;Array&lt;string&gt;&gt; | 是 | 指分布式数据库中数据更改事件的观察者。Array&lt;string>为数据库中的数据发生改变的对端设备ID。 | | observer | Callback&lt;Array&lt;string&gt;&gt; \| Callback&lt;Array&lt;ChangeInfo&gt;&gt;<sup>10+</sup> | 是 | 回调函数。<br>当type为SUBSCRIBE_TYPE_REMOTE，observer类型需为Callback&lt;Array&lt;string&gt;&gt;，其中Array&lt;string&gt;为数据库中的数据发生改变的对端设备ID。<br> 当type为SUBSCRIBE_TYPE_CLOUD，observer类型需为Callback&lt;Array&lt;string&gt;&gt;，其中Array&lt;string&gt;为数据库中的数据发生改变的云端账号ID。 <br> 当type为SUBSCRIBE_TYPE_CLOUD_DETAILS，observer类型需为Callback&lt;Array&lt;ChangeInfo&gt;&gt;，其中Array&lt;ChangeInfo&gt;为数据库端云同步过程的详情。 |
**示例：** **示例：**
...@@ -3340,42 +3349,11 @@ try { ...@@ -3340,42 +3349,11 @@ try {
} }
``` ```
### on('dataChange')<sup>10+</sup>
on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;string&gt;&gt; \| Callback&lt;Array&lt;[ChangeInfo](#changeinfo)&gt;&gt;): void
注册数据库的观察者。当分布式数据库中的数据发生更改时，将调用回调。
**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------------------------------------------------------------- | --- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| event | string | 是 | 取值为'dataChange'，表示数据更改。 |
| type | [SubscribeType](#subscribetype) | 是 | 订阅类型。 |
| observer | Callback&lt;Array&lt;string&gt;&gt; \| Callback&lt;Array&lt;[ChangeInfo](#changeinfo)&gt;&gt; | 是 | 指分布式数据库中数据更改事件的观察者。Array&lt;string>为数据库中的数据发生改变的对端设备ID。 Array&lt;[ChangeInfo](#changeinfo)&gt;为数据库中的数据发生改变的信息，只有订阅类型为SUBSCRIBE_TYPE_CLOUD_DETAILS时才可以使用。 |
**示例：**
```js
function storeObserver(devices) {
for (let i = 0; i < devices.length; i++) {
console.info(`device= ${devices[i]} data changed`);
}
}
try {
store.on('dataChange', relationalStore.SubscribeType.SUBSCRIBE_TYPE_CLOUD_DETAILS, storeObserver);
} catch (err) {
console.error(`Register observer failed, code is ${err.code},message is ${err.message}`);
}
```
### off('dataChange') ### off('dataChange')
off(event:'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;string&gt;&gt;): void off(event:'dataChange', type: SubscribeType, observer?: Callback&lt;Array&lt;string&gt;&gt;\| Callback&lt;Array&lt;ChangeInfo&gt;&gt;): void
从数据库中删除指定类型的指定观察者, 使用callback异步回调。 取消数据变更的事件监听。
**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core
...@@ -3385,7 +3363,7 @@ off(event:'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;stri ...@@ -3385,7 +3363,7 @@ off(event:'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;stri
| -------- | ---------------------------------- | ---- | ------------------------------------------ | | -------- | ---------------------------------- | ---- | ------------------------------------------ |
| event | string | 是 | 取值为'dataChange'，表示数据更改。 | | event | string | 是 | 取值为'dataChange'，表示数据更改。 |
| type | [SubscribeType](#subscribetype) | 是 | 订阅类型。 | | type | [SubscribeType](#subscribetype) | 是 | 订阅类型。 |
| observer | Callback&lt;Array&lt;string&gt;&gt; | 是 | 指已注册的数据更改观察者。Array&lt;string>为数据库中的数据发生改变的对端设备ID。 | | observer | Callback&lt;Array&lt;string&gt;&gt; | 否 | 回调函数。<br/>当type为SUBSCRIBE_TYPE_REMOTE，observer类型需为Callback&lt;Array&lt;string&gt;&gt;，其中Array&lt;string&gt;为数据库中的数据发生改变的对端设备ID。<br/> 当type为SUBSCRIBE_TYPE_CLOUD，observer类型需为Callback&lt;Array&lt;string&gt;&gt;，其中Array&lt;string&gt;为数据库中的数据发生改变的云端账号ID。 <br/> 当type为SUBSCRIBE_TYPE_CLOUD_DETAILS，observer类型需为Callback&lt;Array&lt;ChangeInfo&gt;&gt;，其中Array&lt;ChangeInfo&gt;为数据库端云同步过程的详情。<br> 当observer没有传入时，表示取消当前type类型下所有数据变更的事件监听。 |
**示例：** **示例：**
...@@ -3402,37 +3380,6 @@ try { ...@@ -3402,37 +3380,6 @@ try {
} }
``` ```
### off('dataChange')<sup>10+</sup>
off(event: 'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;string&gt;&gt; \| Callback&lt;Array&lt;[ChangeInfo](#changeinfo)&gt;&gt;): void
从数据库中删除指定类型的指定观察者, 使用callback异步回调。
**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------------------------------------------------------------- | --- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| event | string | 是 | 取值为'dataChange'，表示数据更改。 |
| type | [SubscribeType](#subscribetype) | 是 | 订阅类型。 |
| observer | Callback&lt;Array&lt;string&gt;&gt; \| Callback&lt;Array&lt;[ChangeInfo](#changeinfo)&gt;&gt; | 否 | 指分布式数据库中数据更改事件的观察者。Array&lt;string>为数据库中的数据发生改变的对端设备ID。 Array&lt;[ChangeInfo](#changeinfo)&gt;为数据库中的数据发生改变的信息，只有订阅类型为SUBSCRIBE_TYPE_CLOUD_DETAILS时才可以使用。 |
**示例：**
```js
function storeObserver(devices) {
for (let i = 0; i < devices.length; i++) {
console.info(`device= ${devices[i]} data changed`);
}
}
try {
store.off('dataChange', relationalStore.SubscribeType.SUBSCRIBE_TYPE_CLOUD_DETAILS, storeObserver);
} catch (err) {
console.error(`Unregister observer failed, code is ${err.code},message is ${err.message}`);
}
```
## ResultSet ## ResultSet
提供通过查询数据库生成的数据库结果集的访问方法。结果集是指用户调用关系型数据库查询接口之后返回的结果集合，提供了多种灵活的数据访问方式，以便用户获取各项数据。 提供通过查询数据库生成的数据库结果集的访问方法。结果集是指用户调用关系型数据库查询接口之后返回的结果集合，提供了多种灵活的数据访问方式，以便用户获取各项数据。
...@@ -3906,7 +3853,7 @@ const salary = resultSet.getDouble(resultSet.getColumnIndex("SALARY")); ...@@ -3906,7 +3853,7 @@ const salary = resultSet.getDouble(resultSet.getColumnIndex("SALARY"));
getAsset(columnIndex: number): Asset getAsset(columnIndex: number): Asset
以[Asset](#asset)形式获取当前行中指定列的值。 以[Asset](#asset10)形式获取当前行中指定列的值。
**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core
...@@ -3920,7 +3867,7 @@ getAsset(columnIndex: number): Asset ...@@ -3920,7 +3867,7 @@ getAsset(columnIndex: number): Asset
| 类型 | 说明 | | 类型 | 说明 |
| --------------- | -------------------------- | | --------------- | -------------------------- |
| [Asset](#asset) | 以[Asset](#asset)形式返回指定列的值。 | | [Asset](#asset10) | 以[Asset](#asset10)形式返回指定列的值。 |
**错误码：** **错误码：**
...@@ -3928,7 +3875,7 @@ getAsset(columnIndex: number): Asset ...@@ -3928,7 +3875,7 @@ getAsset(columnIndex: number): Asset
| **错误码ID** | **错误信息** | | **错误码ID** | **错误信息** |
| --------- | ------------------------------------------------------------ | | --------- | ------------------------------------------------------------ |
| 14800013 | The column value is null or the column type is incompatible. | | 14800013 | the column value is null or the column type is incompatible. |
**示例：** **示例：**
...@@ -3938,9 +3885,9 @@ const doc = resultSet.getAsset(resultSet.getColumnIndex("DOC")); ...@@ -3938,9 +3885,9 @@ const doc = resultSet.getAsset(resultSet.getColumnIndex("DOC"));
### getAssets<sup>10+</sup> ### getAssets<sup>10+</sup>
getAsset(columnIndex: number): Assets getAssets(columnIndex: number): Assets
以[Assets](#assets)形式获取当前行中指定列的值。 以[Assets](#assets10)形式获取当前行中指定列的值。
**系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core **系统能力：** SystemCapability.DistributedDataManager.RelationalStore.Core
...@@ -3954,7 +3901,7 @@ getAsset(columnIndex: number): Assets ...@@ -3954,7 +3901,7 @@ getAsset(columnIndex: number): Assets
| 类型 | 说明 | | 类型 | 说明 |
| ---------------- | ---------------------------- | | ---------------- | ---------------------------- |
| [Assets](#assets)| 以[Assets](#assets)形式返回指定列的值。 | | [Assets](#assets10)| 以Assets形式返回指定列的值。 |
**错误码：** **错误码：**
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或