!17225 添加升降级操作

Merge pull request !17225 from LeiiYB/master

zh-cn/application-dev/database/data-persistence-by-rdb-store.md

@@ -57,26 +57,48 @@
    ```js
    import relationalStore from '@ohos.data.relationalStore'; // 导入模块 
    import UIAbility from '@ohos.app.ability.UIAbility';
-   
+
    class EntryAbility extends UIAbility {
      onWindowStageCreate(windowStage) {
        const STORE_CONFIG = {
          name: 'RdbTest.db', // 数据库文件名
          securityLevel: relationalStore.SecurityLevel.S1 // 数据库安全级别
        };
-   
+
+       // 假设当前数据库版本为3，表结构：EMPLOYEE (NAME, AGE, SALARY, CODES)
        const SQL_CREATE_TABLE = 'CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)'; // 建表Sql语句
-   
+
        relationalStore.getRdbStore(this.context, STORE_CONFIG, (err, store) => {
          if (err) {
            console.error(`Failed to get RdbStore. Code:${err.code}, message:${err.message}`);
            return;
          }
          console.info(`Succeeded in getting RdbStore.`);
-         store.executeSql(SQL_CREATE_TABLE); // 创建数据表
-   
+
+        // 当数据库创建时，数据库默认版本为0
+        if (store.version == 0) {
+          store.executeSql(SQL_CREATE_TABLE); // 创建数据表
+          // 设置数据库的版本，入参为大于0的整数
+          store.version = 3;
+        }
+
+        // 如果数据库版本不为0且和当前数据库版本不匹配，需要进行升降级操作
+        // 当数据库存在并假定版本为1时，例应用从某一版本升级到当前版本，数据库需要从1版本升级到2版本
+        if (store.version != 3 && store.version == 1) {
+          // version = 1：表结构：EMPLOYEE (NAME, SALARY, CODES, ADDRESS) => version = 2：表结构：EMPLOYEE (NAME, AGE, SALARY, CODES, ADDRESS)
+          store.executeSql("ALTER TABLE EMPLOYEE ADD COLUMN AGE INTEGER", null);
+          store.version = 2;
+        }
+
+        // 当数据库存在并假定版本为2时，例应用从某一版本升级到当前版本，数据库需要从2版本升级到3版本
+        if (store.version != 3 && store.version == 2) {
+          // version = 2：表结构：EMPLOYEE (NAME, AGE, SALARY, CODES, ADDRESS) => version = 3：表结构：EMPLOYEE (NAME, AGE, SALARY, CODES)
+          store.executeSql("ALTER TABLE EMPLOYEE DROP COLUMN ADDRESS TEXT", null);
+          store.version = 3;
+        }
+
          // 这里执行数据库的增、删、改、查等操作
-   
+
        });
      }
    }
@@ -96,16 +118,38 @@
      name: 'RdbTest.db', // 数据库文件名
      securityLevel: relationalStore.SecurityLevel.S1 // 数据库安全级别
    };
-   
+
+   // 假设当前数据库版本为3，表结构：EMPLOYEE (NAME, AGE, SALARY, CODES)
    const SQL_CREATE_TABLE = 'CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)'; // 建表Sql语句
-   
+
    relationalStore.getRdbStore(context, STORE_CONFIG, (err, store) => {
      if (err) {
        console.error(`Failed to get RdbStore. Code:${err.code}, message:${err.message}`);
        return;
      }
      console.info(`Succeeded in getting RdbStore.`);
-     store.executeSql(SQL_CREATE_TABLE); // 创建数据表
+
+     // 当数据库创建时，数据库默认版本为0
+     if (store.version == 0) {
+        store.executeSql(SQL_CREATE_TABLE); // 创建数据表
+        // 设置数据库的版本，入参为大于0的整数
+        store.version = 3;
+     }
+
+     // 如果数据库版本不为0且和当前数据库版本不匹配，需要进行升降级操作
+     // 当数据库存在并假定版本为1时，例应用从某一版本升级到当前版本，数据库需要从1版本升级到2版本
+     if (store.version != 3 && store.version == 1) {
+        // version = 1：表结构：EMPLOYEE (NAME, SALARY, CODES, ADDRESS) => version = 2：表结构：EMPLOYEE (NAME, AGE, SALARY, CODES, ADDRESS)
+        store.executeSql("ALTER TABLE EMPLOYEE ADD COLUMN AGE INTEGER", null);
+        store.version = 2;
+     }
+
+     // 当数据库存在并假定版本为2时，例应用从某一版本升级到当前版本，数据库需要从2版本升级到3版本
+     if (store.version != 3 && store.version == 2) {
+        // version = 2：表结构：EMPLOYEE (NAME, AGE, SALARY, CODES, ADDRESS) => version = 3：表结构：EMPLOYEE (NAME, AGE, SALARY, CODES)
+        store.executeSql("ALTER TABLE EMPLOYEE DROP COLUMN ADDRESS TEXT", null);
+        store.version = 3;
+     }
    
      // 这里执行数据库的增、删、改、查等操作