แนวทางปฏิบัติที่ดีที่สุดสำหรับการย้ายฐานข้อมูลในแอปสำหรับ Sqlite

Question 1

ฉันใช้ sqlite สำหรับ iphone ของฉันและฉันคาดว่าสคีมาฐานข้อมูลอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป gotchas หลักการตั้งชื่อและสิ่งที่ต้องระวังในการย้ายข้อมูลที่ประสบความสำเร็จในแต่ละครั้งคืออะไร?

ตัวอย่างเช่นฉันคิดที่จะต่อท้ายเวอร์ชันเข้ากับชื่อฐานข้อมูล (เช่น Database_v1)

Question 2

ฉันดูแลแอปพลิเคชันที่ต้องอัปเดตฐานข้อมูล sqlite เป็นระยะและย้ายฐานข้อมูลเก่าไปยังสคีมาใหม่และนี่คือสิ่งที่ฉันทำ:

สำหรับการติดตามเวอร์ชันของฐานข้อมูลฉันใช้ตัวแปรเวอร์ชันผู้ใช้ในตัวที่ sqlite มีให้ (sqlite ไม่ได้ทำอะไรกับตัวแปรนี้คุณมีอิสระที่จะใช้มันได้ตามต้องการ) เริ่มต้นที่ 0 และคุณสามารถรับ / ตั้งค่าตัวแปรนี้ด้วยคำสั่ง sqlite ต่อไปนี้:

> PRAGMA user_version;  
> PRAGMA user_version = 1;

เมื่อแอปเริ่มทำงานฉันจะตรวจสอบเวอร์ชันของผู้ใช้ปัจจุบันใช้การเปลี่ยนแปลงที่จำเป็นเพื่อทำให้สคีมาเป็นปัจจุบันจากนั้นอัปเดตเวอร์ชันของผู้ใช้ ฉันสรุปการอัปเดตในธุรกรรมเพื่อที่ว่าหากมีอะไรผิดพลาดการเปลี่ยนแปลงจะไม่เกิดขึ้น

สำหรับการเปลี่ยนแปลงสคีมา sqlite สนับสนุนไวยากรณ์ "ALTER TABLE" สำหรับการดำเนินการบางอย่าง (เปลี่ยนชื่อตารางหรือเพิ่มคอลัมน์) นี่เป็นวิธีง่ายๆในการอัปเดตตารางที่มีอยู่ในสถานที่ โปรดดูเอกสารที่นี่: http://www.sqlite.org/lang_altertable.html สำหรับการลบคอลัมน์หรือการเปลี่ยนแปลงอื่น ๆ ที่ไวยากรณ์ "ALTER TABLE" ไม่รองรับฉันจะสร้างตารางใหม่ย้ายวันที่ไปวางตารางเก่าและเปลี่ยนชื่อตารางใหม่เป็นชื่อเดิม

Question 3

คำตอบจาก Just Curious นั้นตายไปแล้ว (คุณเข้าใจแล้ว!) และเป็นสิ่งที่เราใช้เพื่อติดตามเวอร์ชันของสคีมาฐานข้อมูลที่อยู่ในแอป

ในการเรียกใช้การย้ายข้อมูลที่จำเป็นต้องเกิดขึ้นเพื่อให้ได้ user_version ที่ตรงกับเวอร์ชันสคีมาที่คาดไว้ของแอปเราใช้คำสั่ง switch นี่คือตัวอย่างที่ตัดทอนของลักษณะนี้ในแอปStripของเรา:

- (void) migrateToSchemaFromVersion:(NSInteger)fromVersion toVersion:(NSInteger)toVersion { 
    // allow migrations to fall thru switch cases to do a complete run
    // start with current version + 1
    [self beginTransaction];
    switch (fromVersion + 1) {
        case 3:
            // change pin type to mode 'pin' for keyboard handling changes
            // removing types from previous schema
            sqlite3_exec(db, "DELETE FROM types;", NULL, NULL, NULL);
            NSLog(@"installing current types");
            [self loadInitialData];
        case 4:
            //adds support for recent view tracking
            sqlite3_exec(db, "ALTER TABLE entries ADD COLUMN touched_at TEXT;", NULL, NULL, NULL);
        case 5:
            {
                sqlite3_exec(db, "ALTER TABLE categories ADD COLUMN image TEXT;", NULL, NULL, NULL);
                sqlite3_exec(db, "ALTER TABLE categories ADD COLUMN entry_count INTEGER;", NULL, NULL, NULL);
                sqlite3_exec(db, "CREATE INDEX IF NOT EXISTS categories_id_idx ON categories(id);", NULL, NULL, NULL);
                sqlite3_exec(db, "CREATE INDEX IF NOT EXISTS categories_name_id ON categories(name);", NULL, NULL, NULL);
                sqlite3_exec(db, "CREATE INDEX IF NOT EXISTS entries_id_idx ON entries(id);", NULL, NULL, NULL);

               // etc...
            }
    }

    [self setSchemaVersion];
    [self endTransaction];
}

Question 4

ให้ฉันแชร์รหัสการย้ายข้อมูลกับ FMDB และ MBProgressHUD

นี่คือวิธีที่คุณอ่านและเขียนหมายเลขเวอร์ชันของสคีมา (ซึ่งน่าจะเป็นส่วนหนึ่งของคลาสโมเดลในกรณีของฉันมันเป็นคลาสซิงเกิลที่เรียกว่าฐานข้อมูล):

- (int)databaseSchemaVersion {
    FMResultSet *resultSet = [[self database] executeQuery:@"PRAGMA user_version"];
    int version = 0;
    if ([resultSet next]) {
        version = [resultSet intForColumnIndex:0];
    }
    return version;
}

- (void)setDatabaseSchemaVersion:(int)version {
    // FMDB cannot execute this query because FMDB tries to use prepared statements
    sqlite3_exec([self database].sqliteHandle, [[NSString stringWithFormat:@"PRAGMA user_version = %d", DatabaseSchemaVersionLatest] UTF8String], NULL, NULL, NULL);
}

นี่คือ[self database]วิธีที่เปิดฐานข้อมูลอย่างเกียจคร้าน:

- (FMDatabase *)database {
    if (!_databaseOpen) {
        _databaseOpen = YES;

        NSString *documentsDir = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0];
        NSString *databaseName = [NSString stringWithFormat:@"userdata.sqlite"];

        _database = [[FMDatabase alloc] initWithPath:[documentsDir stringByAppendingPathComponent:databaseName]];
        _database.logsErrors = YES;

        if (![_database openWithFlags:SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE | SQLITE_OPEN_FILEPROTECTION_COMPLETE]) {
            _database = nil;
        } else {
            NSLog(@"Database schema version is %d", [self databaseSchemaVersion]);
        }
    }
    return _database;
}

และนี่คือวิธีการโยกย้ายที่เรียกจากตัวควบคุมมุมมอง:

- (BOOL)databaseNeedsMigration {
    return [self databaseSchemaVersion] < databaseSchemaVersionLatest;
}

- (void)migrateDatabase {
    int version = [self databaseSchemaVersion];
    if (version >= databaseSchemaVersionLatest)
        return;

    NSLog(@"Migrating database schema from version %d to version %d", version, databaseSchemaVersionLatest);

    // ...the actual migration code...
    if (version < 1) {
        [[self database] executeUpdate:@"CREATE TABLE foo (...)"];
    }

    [self setDatabaseSchemaVersion:DatabaseSchemaVersionLatest];
    NSLog(@"Database schema version after migration is %d", [self databaseSchemaVersion]);
}

และนี่คือรหัสควบคุมมุมมองรูทที่เรียกใช้การโยกย้ายโดยใช้ MBProgressHUD เพื่อแสดงกรอบความคืบหน้า:

- (void)viewDidAppear {
    [super viewDidAppear];
    if ([[Database sharedDatabase] userDatabaseNeedsMigration]) {
        MBProgressHUD *hud = [[MBProgressHUD alloc] initWithView:self.view.window];
        [self.view.window addSubview:hud];
        hud.removeFromSuperViewOnHide = YES;
        hud.graceTime = 0.2;
        hud.minShowTime = 0.5;
        hud.labelText = @"Upgrading data";
        hud.taskInProgress = YES;
        [[UIApplication sharedApplication] beginIgnoringInteractionEvents];

        [hud showAnimated:YES whileExecutingBlock:^{
            [[Database sharedDatabase] migrateUserDatabase];
        } onQueue:dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_BACKGROUND, 0) completionBlock:^{
            [[UIApplication sharedApplication] endIgnoringInteractionEvents];
        }];
    }
}

Question 5

ทางออกที่ดีที่สุด IMO คือการสร้างกรอบการอัพเกรด SQLite ฉันมีปัญหาเดียวกัน (ในโลก C #) และฉันสร้างกรอบของตัวเองขึ้นมา คุณสามารถอ่านเกี่ยวกับเรื่องนี้ที่นี่ มันทำงานได้อย่างสมบูรณ์และทำให้การอัปเกรด (ก่อนหน้านี้ฝันร้าย) ของฉันทำงานได้โดยใช้ความพยายามเพียงเล็กน้อยในด้านข้างของฉัน

แม้ว่าไลบรารีจะถูกนำไปใช้ใน C # แต่แนวคิดที่นำเสนอในที่นั้นก็ควรใช้งานได้ดีในกรณีของคุณเช่นกัน

Question 6

1. สร้าง/migrationsโฟลเดอร์ที่มีรายการการย้ายข้อมูลโดยใช้ SQL ซึ่งการย้ายข้อมูลแต่ละครั้งจะมีลักษณะดังนี้:

/migrations/001-categories.sql

-- Up
CREATE TABLE Category (id INTEGER PRIMARY KEY, name TEXT);
INSERT INTO Category (id, name) VALUES (1, 'Test');

-- Down
DROP TABLE User;

/migrations/002-posts.sql

-- Up
CREATE TABLE Post (id INTEGER PRIMARY KEY, categoryId INTEGER, text TEXT);

-- Down
DROP TABLE Post;

2. สร้างตาราง db ที่มีรายการการย้ายข้อมูลที่ใช้เช่น:

CREATE TABLE Migration (name TEXT);

3. อัปเดตตรรกะ bootstrap ของแอปพลิเคชันเพื่อให้ก่อนที่จะเริ่มระบบจะคว้ารายการการย้ายข้อมูลจาก/migrationsโฟลเดอร์และเรียกใช้การย้ายข้อมูลที่ยังไม่ได้ใช้

นี่คือตัวอย่างที่ใช้กับ JavaScript: SQLite Client สำหรับ Node.js Apps

Question 7

เคล็ดลับบางประการ ...

1) ฉันแนะนำให้ใส่รหัสทั้งหมดเพื่อย้ายฐานข้อมูลของคุณไปยัง NSOperation และเรียกใช้ในเธรดพื้นหลัง คุณสามารถแสดง UIAlertView ที่กำหนดเองด้วยสปินเนอร์ในขณะที่กำลังย้ายฐานข้อมูล

2) ตรวจสอบให้แน่ใจว่าคุณกำลังคัดลอกฐานข้อมูลของคุณจากบันเดิลไปยังเอกสารของแอพและใช้จากตำแหน่งนั้นมิฉะนั้นคุณจะเขียนทับฐานข้อมูลทั้งหมดด้วยการอัปเดตแต่ละแอปจากนั้นย้ายฐานข้อมูลใหม่ที่ว่างเปล่า

3) FMDB ดีมาก แต่เมธอด executeQuery ไม่สามารถทำแบบสอบถาม PRAGMA ได้ด้วยเหตุผลบางประการ คุณจะต้องเขียนวิธีการของคุณเองที่ใช้ sqlite3 โดยตรงหากคุณต้องการตรวจสอบเวอร์ชันสคีมาโดยใช้ PRAGMA user_version

4) โครงสร้างรหัสนี้จะช่วยให้แน่ใจว่าการอัปเดตของคุณจะดำเนินการตามลำดับและการอัปเดตทั้งหมดจะดำเนินการไม่ว่าผู้ใช้จะใช้เวลาระหว่างการอัปเดตแอปนานแค่ไหนก็ตาม สามารถ refactored เพิ่มเติมได้ แต่นี่เป็นวิธีที่ง่ายมากในการดู วิธีนี้สามารถทำงานได้อย่างปลอดภัยทุกครั้งที่มีการสร้างอินสแตนซ์ข้อมูลของคุณซิงเกิลตันและมีค่าใช้จ่ายเพียงหนึ่งแบบสอบถามฐานข้อมูลเล็ก ๆ ที่เกิดขึ้นเพียงครั้งเดียวต่อเซสชันหากคุณตั้งค่าข้อมูลเดี่ยวอย่างถูกต้อง

- (void)upgradeDatabaseIfNeeded {
    if ([self databaseSchemaVersion] < 3)
    {
        if ([self databaseSchemaVersion] < 2)
        {
            if ([self databaseSchemaVersion] < 1)
            {
                // run statements to upgrade from 0 to 1
            }
            // run statements to upgrade from 1 to 2
        }
        // run statements to upgrade from 2 to 3

        // and so on...

        // set this to the latest version number
        [self setDatabaseSchemaVersion:3];
    }
}

Question 8

หากคุณเปลี่ยนสคีมาฐานข้อมูลและรหัสทั้งหมดที่ใช้ในขั้นตอนล็อกเช่นเดียวกับที่เป็นไปได้ในแอพที่ฝังตัวและที่อยู่ในโทรศัพท์ปัญหานั้นอยู่ภายใต้การควบคุมที่ดี (ไม่มีอะไรเทียบได้กับฝันร้ายนั่นคือการย้ายสคีมาบนฐานข้อมูลขององค์กร ที่อาจให้บริการแอพหลายร้อยแอพไม่ใช่ทั้งหมดที่อยู่ภายใต้การควบคุมของ DBA ;-)

Question 9

สำหรับ. net คุณสามารถใช้ lib:

EntityFrameworkCore.Sqlite.Migrations

มันง่ายมากดังนั้นสำหรับแพลตฟอร์มอื่น ๆ คุณสามารถใช้พฤติกรรมเดียวกันกับใน lib ได้อย่างง่ายดาย