• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 模块描述
2<!--Kit: ArkData-->
3<!--Subsystem: DistributedDataManager-->
4<!--Owner: @baijidong-->
5<!--Designer: @widecode; @htt1997-->
6<!--Tester: @yippo; @logic42-->
7<!--Adviser: @ge-yafang-->
8
9关系型数据库(Relational Database,RDB)是一种基于关系模型来管理数据的数据库。关系型数据库基于SQLite组件提供了一套完整的对本地数据库进行管理的机制,对外提供了一系列的增、删、改、查等接口,也可以直接运行用户输入的SQL语句来满足复杂的场景需要。支持通过[ResultSet.getSendableRow](arkts-apis-data-relationalStore-ResultSet.md#getsendablerow12)方法获取Sendable数据,进行跨线程传递。
10
11为保证插入并读取数据成功,建议一条数据不超过2MB。如果数据超过2MB,插入操作将成功,读取操作将失败。
12
13大数据量场景下查询数据可能会导致耗时长甚至应用卡死,如有相关操作可参考文档[批量数据写数据库场景](../../arkts-utils/batch-database-operations-guide.md),且有建议如下:
14- 单次查询数据量不超过5000条。
15- 在[TaskPool](../apis-arkts/js-apis-taskpool.md)中查询。
16- 拼接SQL语句尽量简洁。
17- 合理地分批次查询。
18
19该模块提供以下关系型数据库相关的常用功能:
20
21- [RdbPredicates](arkts-apis-data-relationalStore-RdbPredicates.md):数据库中用来代表数据实体的性质、特征或者数据实体之间关系的词项,主要用来定义数据库的操作条件。
22- [RdbStore](arkts-apis-data-relationalStore-RdbStore.md):提供管理关系数据库(RDB)方法的接口。
23- [ResultSet](arkts-apis-data-relationalStore-ResultSet.md):提供用户调用关系型数据库查询接口之后返回的结果集合。
24- [Transaction](arkts-apis-data-relationalStore-Transaction.md):提供管理事务对象的接口。
25
26> **说明:**
27>
28> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
29
30## 导入模块
31
32```ts
33import { relationalStore } from '@kit.ArkData';
34```