数据库升级

原

Android数据库表升级(添加列)，并保留原表中的数据---以后有其他升级操作将会更新该文

2017年01月05日 11:34:30

阅读数：2605

        最近项目中需要为数据库中已存在的表添加新的字段，这也是当初设计表时的不足，前人留坑，后人遭殃。。。。并且更过分的是，发现数据库设计的严重缺陷！！有很多个库，每个库中都有所有的表，但是每个库用到的只是其中一张表。。。

        好吧，废话不多说！！

        步骤：

        1、首先第一步是更改数据库的 version，当检测到你当前版本比之前的高后会执行onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)方法，这个方法中第一个参数 db 就是你构造方法中的数据库对象，第二个参数 oldVersion 就是你当前数据库之前的版本，第三个参数 newVersion就是当前数据库现在要升级到的版本。在这个方法里需要对不同版本做不同的操作，假设：

        当前使用app的用户该数据库版本为 1 ，而你现在新数据库版本为 2 ，那么你需要把 1 -> 2版本之间的变化写到一起，比如你在版本更新到 2 时添加了一个列，就要把一个列插入表中。

        当前使用app的用户改数据库版本为 1 或者为 2 ，而你现在新数据库版本为 3 ，那么你需要把 1 -> 3 版本之间所有的变化写到一起，比如你在版本从 1 更新到 2 时添加了一个列，从 2 更新到 3 时添加了二个列，这个时候你就要分情况处理了，如果用户是直接从 1 升到 3 ，那么你要添加三个列，如果用户是从 2 升到 3 ，那么你要添加二个列。

        2、在 onUpgrade 中做添加字段或者删除字段的操作！！！！注意：这里有两种需求！！第一种：不需要保留原表的数据，在我现在公司项目中有一张表要修改一个列名，但是每次使用的都是新数据，所以可以直接删除原表，再重新创建表！第二种：需要保留原数据，只不过后续app的版本添加了功能需要在该表中使用新的列！这里我解决的是第二种情况，也就是需要保留原数据的情况！

        先写思路，最后贴代码，这里以 user 表为例：

        (1)将原来的表更改名字为一张临时表：  "alert table user rename to_temp_user"  ，临时表名可以自己定义，我定义的是  _temp_+原表名 ，比如原表名为 user 表，临时表名就为  _temp_user 。

        (2)创建一张新表，表名为原来的表名，注意：这里的新表中的列要有你需要添加的列，并将新的列添加的原表中的末尾："create table if not exists user(表中列名和数据类型，多个列以,逗号隔开 )" 。

        (3)将临时表的数据复制到名字为原来表名的新表(这里有一点要注意，因为新的列是在末尾，所以这里我们要预留值给新列，如果没有预留值我也不知道会出什么问题。。。欢迎博友给出意见！！)具体的实现细节在接下来的sql语句中体现："insert into user select *,' ' from _temp_user" ，这里select * 之后的单引号之间有空格，如果添加多个字段就添加多个' '，以逗号隔开，比如添加两个字段："insert into user select *,' ',' ' form _temp_user"，意思就是给新添加的列赋值为 ' ' ！！

        (4)将临时表删除，数据已经复制完毕，有新添加列的表已经生成并保留了数据，临时表已经没用利用价值了，删吧，任性一回！！删除sql语句："drop  table _temp_user"。

        升级表的操作就结束了！接下来该贴出代码了：

1.   /**
2. * 在表中添加字段方法 操作步骤： 1、先更改表名 2、创建新表,表名为原来的表名 3、复制数据 4、删除旧表
3. *
4. * @param db
5. * 数据库名
6. * @param newColumnArr
7. * 添加的新字段的表名数组
8. * @param oldTableName
9. * 旧表名，在方法内部将旧表名修改为 _temp_+oldTableName
10. */
11. private void addColumn(SQLiteDatabase db, String[] newColumnArr,
12. String oldTableName) {
14. if (db == null || newColumnArr == null || newColumnArr.length < 1
15. || TextUtils.isEmpty(oldTableName)) {
16. // 数据库为空，新字段个数为0，添加字段后的字段数组个数为0，旧表名为空
17. return;
18. }
20. // 拿到旧表中所有的数据
21. Cursor cursor = db.rawQuery( "select * from " + oldTableName, null);
22. if (cursor == null) {
23. // 如果游标为空，说明旧表中没有数据，如果是这种情况那就可以直接改表的字段，不需要转移数据了，代码后面也有，省略掉复制数据的操作就好
24. return;
25. }
26. // 拿到原来的表中所有的字段名
27. String[] oldColumnNames = cursor.getColumnNames();
29. // 更改原表名为临时表
30. String tempTableName = "_temp_" + oldTableName;
31. db.execSQL(
32. "alter table " + oldTableName + " rename to " + tempTableName);
34. // 创建新表
35. if (oldColumnNames.length < 1) {
36. // 如果原来的表中字段个数为0
37. return;
38. }
40. // 创建一个线程安全的字符串缓冲对象，防止用conn多线程访问数据库时造成线程安全问题
41. StringBuffer createNewTableStr = new StringBuffer();
42. createNewTableStr
43. .append( "create table if not exists " + oldTableName + "(");
44. for ( int i = 0; i < oldColumnNames.length; i++) {
45. if (i == 0) {
46. createNewTableStr.append(oldColumnNames[i]
47. + " integer primary key autoincrement,");
48. } else {
49. createNewTableStr.append(oldColumnNames[i] + ",");
50. }
51. }
53. for ( int i = 0; i < newColumnArr.length; i++) {
54. if (i == newColumnArr.length - 1) {
55. // 最后一个
56. createNewTableStr.append(newColumnArr[i] + ")");
57. } else {
58. // 不是最后一个
59. createNewTableStr.append(newColumnArr[i] + ",");
60. }
61. }
63. db.execSQL(createNewTableStr.toString());
65. // 复制旧表数据到新表
66. StringBuffer copySQLStr = new StringBuffer();
67. copySQLStr.append( "insert into " + oldTableName + " select *,");
68. // 有多少个新的字段，就要预留多少个' '空值给新字段
69. for ( int i = 0; i < newColumnArr.length; i++) {
70. if (i == newColumnArr.length - 1) {
71. // 最后一个
72. copySQLStr.append( "' ' from " + tempTableName);
73. } else {
74. // 不是最后一个
75. copySQLStr.append( "' ',");
76. }
77. }
79. db.execSQL(copySQLStr.toString());
81. // 删除旧表
82. db.execSQL( "drop table " + tempTableName);
84. // 关闭游标
85. cursor.close();
86. }

        这个添加新列的方法亲测可用，应该大家可以直接拿到自己的项目中使用！我秉承了写代码的好习惯，注释的还算清晰吧！！

        还是解释一下这个方法的参数吧，里面的逻辑就不再过多解释了：

                第一个参数 SQLiteDatabase db ，很简单，数据库对象，需要对其操作的数据库！

                第二个参数 String[] newColumnArr ，需要添加新列的列名数组！

                第三个参数 String oldTableName ，需要升级的表名！

        好了！！终于写完了！！有不对之处欢迎大家指正，共同进步！！！