iOS SQLite 數(shù)據(jù)庫(kù)遷移

1、概述

隨著應(yīng)用的不斷升級(jí)，原有的數(shù)據(jù)庫(kù)結(jié)構(gòu)不再適應(yīng)新的功能，這時(shí)候，就需要對(duì)SQLite數(shù)據(jù)庫(kù)的結(jié)構(gòu)進(jìn)行遷移升級(jí)。推薦使用 FMDBMigrationManager。

2、FMDBMigrationManager

FMDBMigrationManager對(duì)數(shù)據(jù)的操作是基于FMDB的，所以必須在項(xiàng)目中引入FMDB

Podfile 文件：

use_frameworks!
platform :ios, '8.0'
target ‘AppName’ do

# SQLite 本地?cái)?shù)據(jù)庫(kù)
pod 'FMDB'

# SQLite 本地?cái)?shù)據(jù)庫(kù)版本升級(jí)管理

pod 'FMDBMigrationManager'

2.1、實(shí)現(xiàn)細(xì)節(jié)

FMDBMigrationManager對(duì)版本的管理通過(guò)在數(shù)據(jù)庫(kù)中引入一個(gè)schema_migrations表。表的每一個(gè)行記錄著一個(gè)應(yīng)用的版本號(hào)。

CREATE TABLE schema_migrations(
    version INTEGER UNIQUE NOT NULL
);

2.2、版本號(hào)的命名

推薦使用時(shí)間戳的方式來(lái)命名，可使用下面的語(yǔ)法來(lái)生成。

ruby -e "puts Time.now.strftime('%Y%m%d%H%M%S%3N').to_i"

2.3、遷移文件的命名

通過(guò)（版本號(hào)_描述文字）.sql 的方式來(lái)命名。描述文字是可選的的。

2.4、生成sql文件

可通過(guò)下面的命令生成

touch "`ruby -e "puts Time.now.strftime('%Y%m%d%H%M%S%3N').to_i"`"_CreateMyAwesomeTable.sql

2.4、 計(jì)算未應(yīng)用的遷移

使用下面的算法來(lái)指定給數(shù)據(jù)的遷移

  1. 計(jì)算database的origin version
  2. 對(duì)于給定bundle的的migrations(遷移)創(chuàng)建一個(gè)包含version的數(shù)組
  3. 創(chuàng)建一個(gè)包含所以應(yīng)用到database的遷移版本（SELECT version FROM schema_migrations）
  4. 從列表中移除所以比origin version小的migration
  5. 比較遷移數(shù)組的差異。剩余的集合是（pending migrations）待遷移的集合。
  6. 對(duì)pending migrations進(jìn)行升序排列，并對(duì)其從舊到新的應(yīng)用進(jìn)行數(shù)據(jù)庫(kù)的遷移。

3、用法

3.1、通過(guò).sql文件進(jìn)行遷移升級(jí)

  • 創(chuàng)建第一個(gè).sql 文件
$ touch "`ruby -e "puts Time.now.strftime('%Y%m%d%H%M%S%3N').to_i"`"_CreateMyUserTable.sql
  • 編輯.sql文件 輸入下面的命令
// 創(chuàng)建User表
CREATE TABLE User(
id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
name TEXT
);
  • 創(chuàng)建第二個(gè).sql 文件
$touch "`ruby -e "puts Time.now.strftime('%Y%m%d%H%M%S%3N').to_i"`"_CreateMyGroupTable.sql
  • 編輯.sql文件 輸入下面的命令
// 創(chuàng)建Grouping表，并修改User表添加一個(gè)TEXT類(lèi)型的email字段
CREATE TABLE Grouping(
id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
name TEXT
);

ALTER TABLE User ADD email TEXT;
  • 創(chuàng)建第三個(gè).sql 文件
$ touch "`ruby -e "puts Time.now.strftime('%Y%m%d%H%M%S%3N').to_i"`"_AlterMyGroupTable.sql
  • 編輯.sql文件 輸入下面的命令
// 修改Grouping表添加一個(gè)TEXT類(lèi)型的remark字段
ALTER TABLE Grouping ADD remark TEXT;
  • 具體用法代碼
// 創(chuàng)建.sql文件的方式進(jìn)行遷移, 自動(dòng)掃描包內(nèi)以.sql結(jié)尾的文件
    func migrate1() {
        //db路徑
        let path = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)
        let filePath = path.first?.appendingPathComponent("User.db").path
        
        // 遷移管理器
        let manager = FMDBMigrationManager(databaseAtPath: filePath, migrationsBundle: Bundle.main)!
       
                // 判斷是否有遷移表，如果沒(méi)有 則創(chuàng)建 schema_migrations表 里面記錄著創(chuàng)建的版本信息
        if !manager.hasMigrationsTable  {
            do {
                try  manager.createMigrationsTable()
            }catch{
                print("createMigrationsTable- error: \(error)")
            }
        }
        // 遷移數(shù)據(jù)庫(kù)
        do {
            try  manager.migrateDatabase(toVersion: UINT64_MAX, progress: nil)
        }catch{
            print("migrateDatabase - error: \(error)")
        }
        
        // 遷移表 存儲(chǔ)版本號(hào)信息
        print("Has `schema_migrations` table?: ", manager.hasMigrationsTable ? "true" : "false")
        // 原始版本
        print("Origin Version: ", manager.originVersion)
        // 當(dāng)前版本
        print("Current version: ", manager.currentVersion)
        // 所有的版本
        print("All migrations: ", manager.migrations)
        // 這次更新應(yīng)用的版本
        print("Applied versions: ", manager.appliedVersions)
        // 要更新的版本
        print("Pending versions: ", manager.pendingVersions)
        
        /**
         Has `schema_migrations` table?:  true
        Origin Version:  0
        Current version:  20170315173002899
        All migrations:  [<Alert___Custom.FSMigration: 0x600000671e80>, <FMDBFileMigration: 0x60800002f300>, <FMDBFileMigration: 0x60800002f3c0>, <FMDBFileMigration: 0x60800002f480>]
        Applied versions:  [0, 20170315171810827, 20170315172759084, 20170315173002899]
        Pending versions:  []
 **/
    }

3.2、通過(guò)自定義對(duì)象進(jìn)行遷移升級(jí)

定義對(duì)象FSMigration 遵循FMDBMigrating協(xié)議

class FSMigration: NSObject, FMDBMigrating {

    // 只讀 計(jì)算屬性
    var name: String! {
        return myName
    }
    var version: UInt64 {
        return myVersion
    }
    private var updateArray = [String]() // 更新數(shù)組
    
    private var myName:String!  // 名字
    private var myVersion: UInt64 = 0 // 版本
    
    override init() {
        super.init()
    }
    convenience init(name:String, version: UInt64, updateArray:[String]) {
        self.init()
        myName = name
        myVersion = version
        self.updateArray = updateArray
        
        print("self.updateArray: \(self.updateArray)")

    }
    func migrateDatabase(_ database: FMDatabase!) throws {
        
        print("updateArray: \(self.updateArray)")
        for updateStr in self.updateArray {
            do {
                try database.executeUpdate(updateStr, values: nil)
            }catch {
                throw error
            }
        }
    }
    
}
  • 具體使用代碼
// 數(shù)據(jù)庫(kù)表遷移
    func migrate() {
        
        //db路徑
        let path = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)
        let filePath = path.first?.appendingPathComponent("person.db").path
        
        // 遷移管理器
        let manager = FMDBMigrationManager(databaseAtPath: filePath, migrationsBundle: Bundle.main)!
        // 版本 1
        let migration1 = FSMigration(name: "新增User表", version: 1, updateArray: ["create table User(id integer primary key autoincrement, name text, age integer)"])
        // 版本 2
         let migration2 = FSMigration(name: "USer表新增字段email", version: 2, updateArray: ["alter table User add email text"])
        
        // 報(bào)錯(cuò) 不能修改
        let migration3 = FSMigration(name: "修改email類(lèi)型為integer", version: 3, updateArray: ["alter table User alter column email integer"])
        // 報(bào)錯(cuò) 不能刪除
        let migration4 = FSMigration(name: "刪除email列", version: 4, updateArray: ["ALTER TABLE User DROP COLUMN email"])
        
        // 添加版本到 manager
        manager.addMigration(migration1)
        manager.addMigration(migration2)
        
        manager.addMigration(migration3)
        manager.addMigration(migration4)

        
        // 判斷是否有遷移表，如果沒(méi)有 則創(chuàng)建 schema_migrations表 里面記錄著創(chuàng)建的版本信息
            if !manager.hasMigrationsTable  {
                do {
                    try  manager.createMigrationsTable()
                }catch{
                    print("createMigrationsTable- error: \(error)")
                }
            }
       // 遷移數(shù)據(jù)庫(kù)
        do {
            try  manager.migrateDatabase(toVersion: UINT64_MAX, progress: nil)
        }catch{
            print("migrateDatabase - error: \(error)")
        }
        
        print("Has `schema_migrations` table?: ", manager.hasMigrationsTable ? "true" : "false")
        print("Origin Version: ", manager.originVersion)
        print("Current version: ", manager.currentVersion)
        print("All migrations: ", manager.migrations)
        print("Applied versions: ", manager.appliedVersions)
        print("Pending versions: ", manager.pendingVersions)
    }

4、修改SQLite數(shù)據(jù)庫(kù)的限制性

SQLite supports a limited subset of ALTER TABLE. The ALTER TABLE command in SQLite allows the user to rename a table or to add a new column to an existing table. It is not possible to rename a column, remove a column, or add or remove constraints from a table.

SQLite 對(duì) ALERT TABLE 命令受限制，SQLite 中的 ALERT TABLE 命令只能允許用戶重命名表或者添加新列，不能重命名列或者刪除列或者刪除約束。

5、參考

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書(shū)系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

推薦閱讀更多精彩內(nèi)容