# RDBBasicUse

**Repository Path**: scenario-samples/rdbbasic-use

## Basic Information

- **Project Name**: RDBBasicUse
- **Description**: 【鸿蒙 Harmony Next 示例 代码】本示例展示了insert、update、delete、query接口及关系型数据库谓词predicates 的数据库基础操作。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-03-11
- **Last Updated**: 2025-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基于RDB已提供API的数据库基础使用

## 介绍

本示例展示了insert、update、delete、query接口及关系型数据库谓词predicates 的数据库基础操作。 
RdbPredicates：数据库中用来代表数据实体的性质、特征或者数据实体之间关系的词项，主要用来定义数据库的操作条件。
常用的方法有equalTo,notEqualTo,or,and,isnull,between,orderby,groupby等。

## 效果预览

![image](screenshots/ScreenShot.gif)

## 约束与限制

1.仅支持标准系统上运行，支持设备：华为手机或运行在DevEco Studio上的华为手机设备模拟器。  
2.支持 API Version 12 Release及以上版本。  
3.支持 HarmonyOS 5.0.0 Release SDK及以上版本。  
4.需要使用DevEco Studio 5.0.0 Release及以上版本进行编译运行。

## 使用说明
第一步创建数据库，后续进行添加，查询，删除，更新操作。

## 实现思路

1. 创建数据库
```typescript
createTable() {
  const SQL_CREATE_TABLE =
    'CREATE TABLE IF NOT EXISTS STUDENT (ID INTEGER PRIMARY KEY AUTOINCREMENT,NAME TEXT ,AGE INTEGER,SALARY REAL);'
  if (this.rdbStore) {
    this.rdbStore.executeSql(SQL_CREATE_TABLE);
  }
}
```
2. 插入数据
```typescript
insertData(name: string, age: number, salary: number) {
  // 插入数据
  const valueBucket: ValuesBucket = {
    'NAME': name,
    'AGE': age,
    'SALARY': salary
  };
  if (this.rdbStore) {
    this.rdbStore.insert('STUDENT', valueBucket, (err, rowId) => {
      if (err) {
        console.error(`Failed to insert data. Code:${err.code}, message:${err.message}`);
        return;
      }
      console.info(`Succeeded in inserting data. rowId:${rowId}`);
    })
  }
}
```
3.  删除数据
```typescript
deleteData(name: string) {
  let predicates = new relationalStore.RdbPredicates('STUDENT');
  predicates.equalTo('NAME', name);
  if (this.rdbStore !== undefined) {
    (this.rdbStore as relationalStore.RdbStore).delete(predicates, (err, rows) => {
      if (err) {
        console.error(`Delete failed, code is ${err.code},message is ${err.message}`);
      }
      console.info(`Delete rows: ${rows}`);
    })
  }
}
```

4. 后续详见代码


## 工程目录

```
entry/src/main/ets/
|---database
|   |---Rdb.ets
|---entryability
|   |---EntryAbility.ets
|---pages
|   |---Index.ets            // Demo主页面  
                    
```

## 模块依赖

无

## 参考文档

[@ohos.data.relationalStore (关系型数据库)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-data-relationalstore-V14)

## ChangeLog

| 修改内容   | 时间         |
|--------|------------|
| 第一次提交  | 2025.03.11 |