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, а в каждом из case используйте номер версии, чтобы отслеживать текущую версию базы данных.

Лучше всего выполнить цикл от 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

Обработка версий баз данных является очень важной частью разработки приложений.Я предполагаю, что у вас уже есть класс AppDbHelper, расширяющий SQLiteOpenHelper.Когда вы расширяете его, вам нужно будет реализовать методы onCreate и onUpgrade.

1. Когда onCreate и onUpgrade методы вызывают

   • onCreate вызывается, когда приложение только что установлено.
   • onUpgrade вызывается при обновлении приложения.

2. Организация версий базы данных Я управляю версиями в классе методами.Создать реализацию интерфейса Migration.Например, для первой версии создайте 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.
     }
   }

Использование классов миграции

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

Answer 5

@ jkschneider ответ правильный. Однако есть лучший подход.

Запишите необходимые изменения в файл sql для каждого обновления, как описано в ссылке https://riggaroo.co.za/android-sqlite-database-use-onupgrade-correctly/

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