Android：升级数据库版本并添加新表

Question

我已经为我的应用创建了 sqlite 表，但现在我想向数据库中添加一个新表。

我更改了数据库版本如下

private static final int DATABASE_VERSION = 2;

并添加字符串以创建表

private static final String DATABASE_CREATE_color = 
   "CREATE TABLE IF NOT EXISTS files(color text, incident_id text)";

onCreate 和onUpgrade 如下：

@Override
    public void onCreate(SQLiteDatabase database) {
        database.execSQL(DATABASE_CREATE_incident);
        database.execSQL(DATABASE_CREATE_audio);
        database.execSQL(DATABASE_CREATE_video);
        database.execSQL(DATABASE_CREATE_image);

    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        //drop table and add new tables when version 2 released.
        db.execSQL(DATABASE_CREATE_color);

    }

但由于某种原因，没有创建新表。我做错了什么？

Answer 1

1.关于 onCreate() 和 onUpgrade()

onCreate(..) 在新安装应用程序时被调用。 onUpgrade 在应用程序升级和启动时调用，数据库版本 不一样。

2。增加数据库版本

你需要这样的构造函数：

MyOpenHelper(Context context) {
   super(context, "dbname", null, 2); // 2 is the database version
}

重要提示：仅增加应用版本不足以调用 onUpgrade！

3。不要忘记您的新用户！

别忘了添加

database.execSQL(DATABASE_CREATE_color);

您的 onCreate() 方法也一样，否则新安装的应用程序将缺少该表。

4.如何处理随时间发生的多个数据库更改

当你有连续的应用升级，其中有几个有数据库升级，你要确保检查oldVersion：

onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
   switch(oldVersion) {
   case 1:
       db.execSQL(DATABASE_CREATE_color);
       // we want both updates, so no break statement here...
   case 2:
       db.execSQL(DATABASE_CREATE_someothertable); 
   }
}

这样，当用户从版本 1 升级到版本 3 时，他们会同时获得两个更新。当用户从第 2 版升级到第 3 版时，他们只会获得第 3 版更新...毕竟，您不能指望 100% 的用户群在每次发布更新时都进行升级。有时他们会跳过更新或 12 :)

5.在开发过程中控制您的修订号

最后……打电话

adb uninstall <yourpackagename>

完全卸载应用程序。当您再次安装时，您一定会点击onCreate，这样您就不必在开发过程中不断增加数据库版本...

Answer 2

您的代码看起来正确。我的建议是数据库已经认为它已经升级了。如果您在增加版本号之后执行该项目，但在添加 execSQL 调用之前，您的测试设备/模拟器上的数据库可能已经认为它是版本 2。

验证这一点的快速方法是将版本号更改为 3 - 如果在此之后升级，您知道这只是因为您的设备认为它已经升级。

Answer 3

您可以使用 SQLiteOpenHelper 的 onUpgrade 方法。在 onUpgrade 方法中，您将 oldVersion 作为参数之一。

在onUpgrade 中使用switch，在每个cases 中使用版本号来跟踪数据库的当前版本。

最好从oldVersion 循环到newVersion，每次将version 递增1，然后逐步升级数据库。当使用数据库版本 1 的用户长时间升级应用程序到使用数据库版本 7 的版本并且应用程序由于某些不兼容的更改而开始崩溃时，这非常有用。

然后数据库中的更新将逐步完成，涵盖所有可能的情况，即合并数据库中为每个新版本所做的更改，从而防止您的应用程序崩溃。

例如：

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
    switch (oldVersion) {
    case 1:
        String sql = "ALTER TABLE " + TABLE_SECRET + " ADD COLUMN " + "name_of_column_to_be_added" + " INTEGER";
        db.execSQL(sql);
        break;

    case 2:
        String sql = "SOME_QUERY";
        db.execSQL(sql);
        break;
    }

}

Answer 4

@jkschneider 的回答是正确的。但是，有更好的方法。

如链接https://riggaroo.co.za/android-sqlite-database-use-onupgrade-correctly/中所述，将每次更新所需的更改写入sql文件中

from_1_to_2.sql

ALTER TABLE books ADD COLUMN book_rating INTEGER;

from_2_to_3.sql

ALTER TABLE books RENAME TO book_information;

from_3_to_4.sql

ALTER TABLE book_information ADD COLUMN calculated_pages_times_rating INTEGER;
UPDATE book_information SET calculated_pages_times_rating = (book_pages * book_rating) ;

这些.sql文件会根据数据库的版本在onUpgrade()方法中执行。

DatabaseHelper.java

public class DatabaseHelper extends SQLiteOpenHelper {

    private static final int DATABASE_VERSION = 4;

    private static final String DATABASE_NAME = "database.db";
    private static final String TAG = DatabaseHelper.class.getName();

    private static DatabaseHelper mInstance = null;
    private final Context context;

    private DatabaseHelper(Context context) {
        super(context, DATABASE_NAME, null, DATABASE_VERSION);
        this.context = context;
    }

    public static synchronized DatabaseHelper getInstance(Context ctx) {
        if (mInstance == null) {
            mInstance = new DatabaseHelper(ctx.getApplicationContext());
        }
        return mInstance;
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(BookEntry.SQL_CREATE_BOOK_ENTRY_TABLE);
        // The rest of your create scripts go here.

    }


    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        Log.e(TAG, "Updating table from " + oldVersion + " to " + newVersion);
        // You will not need to modify this unless you need to do some android specific things.
        // When upgrading the database, all you need to do is add a file to the assets folder and name it:
        // from_1_to_2.sql with the version that you are upgrading to as the last version.
        try {
            for (int i = oldVersion; i < newVersion; ++i) {
                String migrationName = String.format("from_%d_to_%d.sql", i, (i + 1));
                Log.d(TAG, "Looking for migration file: " + migrationName);
                readAndExecuteSQLScript(db, context, migrationName);
            }
        } catch (Exception exception) {
            Log.e(TAG, "Exception running upgrade script:", exception);
        }

    }

    @Override
    public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) {

    }

    private void readAndExecuteSQLScript(SQLiteDatabase db, Context ctx, String fileName) {
        if (TextUtils.isEmpty(fileName)) {
            Log.d(TAG, "SQL script file name is empty");
            return;
        }

        Log.d(TAG, "Script found. Executing...");
        AssetManager assetManager = ctx.getAssets();
        BufferedReader reader = null;

        try {
            InputStream is = assetManager.open(fileName);
            InputStreamReader isr = new InputStreamReader(is);
            reader = new BufferedReader(isr);
            executeSQLScript(db, reader);
        } catch (IOException e) {
            Log.e(TAG, "IOException:", e);
        } finally {
            if (reader != null) {
                try {
                    reader.close();
                } catch (IOException e) {
                    Log.e(TAG, "IOException:", e);
                }
            }
        }

    }

    private void executeSQLScript(SQLiteDatabase db, BufferedReader reader) throws IOException {
        String line;
        StringBuilder statement = new StringBuilder();
        while ((line = reader.readLine()) != null) {
            statement.append(line);
            statement.append("\n");
            if (line.endsWith(";")) {
                db.execSQL(statement.toString());
                statement = new StringBuilder();
            }
        }
    }
}

同一链接中还提供了一个示例项目：https://github.com/riggaroo/AndroidDatabaseUpgrades

Answer 5

处理数据库版本是应用程序开发中非常重要的一部分。我假设您已经拥有扩展 SQLiteOpenHelper 的类 AppDbHelper。当你扩展它时，你需要实现onCreate 和onUpgrade 方法。

1. 当onCreate 和onUpgrade 方法被调用时

   • onCreate 新安装应用时调用。
   • onUpgrade 在应用更新时调用。

2. 组织数据库版本 我在类方法中管理版本。创建接口迁移的实现。例如。第一个版本创建MigrationV1 类，第二个版本创建MigrationV1ToV2（这些是我的命名约定）

    public interface Migration {
        void run(SQLiteDatabase db);//create tables, alter tables
    }

迁移示例：

public class MigrationV1ToV2 implements Migration{
      public void run(SQLiteDatabase db){
        //create new tables
        //alter existing tables(add column, add/remove constraint)
        //etc.
     }
   }

1. 使用迁移类

onCreate: 因为onCreate会在应用新安装的时候被调用，所以我们还需要执行所有的迁移（数据库版本更新）。所以onCreate 看起来像这样：

public void onCreate(SQLiteDatabase db){
        Migration mV1=new MigrationV1();
       //put your first database schema in this class
        mV1.run(db);
        Migration mV1ToV2=new MigrationV1ToV2();
        mV1ToV2.run(db);
        //other migration if any
  }

onUpgrade：当应用程序已经安装并更新到新的应用程序版本时，将调用此方法。如果应用程序包含任何数据库更改，则将所有数据库更改放入新的迁移类并增加数据库版本。

例如，假设用户安装了数据库版本 1 的应用程序，现在数据库版本更新为 2（所有架构更新都保存在 MigrationV1ToV2 中）。现在，当应用程序升级时，我们需要通过在MigrationV1ToV2 中应用数据库架构更改来升级数据库，如下所示：

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
    if (oldVersion < 2) {
        //means old version is 1
        Migration migration = new MigrationV1ToV2();
        migration.run(db);
    }
    if (oldVersion < 3) {
        //means old version is 2
    }
}

注意：对数据库架构的所有升级（在onUpgrade 中提到）都应在onCreate 中执行