Room 中的数据库迁移
在以往的数据库升级中,每当数据库 schema 发生变化时,开发者都必须实现 Migration 类,并将实际变化告知 Room,需要开发者编写和执行复杂的 SQL 查询。不过从2.4.0-alpha01 版本开始,Room 库里新加入了自动迁移的功能,这让数据库迁移的实现变得更简单。
现在,使用自动迁移功能,您就可以指定从哪个版本迁移到哪个版本了。Room 可以针对不是很复杂的情况自动生成迁移程序,例如添加或删除列、创建新的数据库表。但是在模棱两可的场景下,Room 则需要一些帮助。开发者可以提供具体的规范——比如重命名或删除列/数据库表——基于此,Room 将为您生成并运行迁移动作。接下来让我们一起看一些例子,以及具体的运行表现吧!
1,在自动迁移中加入自动元素
举例来说,我们需要在数据库中的一个表中新添加一列,并将数据库从版本 1 升级到版本 2。那么我们就需要更新 @Database 注解为其递增版本号,并添加从版本 1 到 2 的自动迁移,代码如下。
/* Copyright 2020 Google LLC. SPDX-License-Identifier: Apache-2.0 */@Database(
- version = 1,
+ version = 2,entities = [ Doggos.class ],
+ autoMigrations = [
+ AutoMigration (from = 1, to = 2)
+ ])
abstract class DoggosDatabase : RoomDatabase { }
每当数据库版本再次改变时,您只需更新 autoMigrations 列表,添加一个新的AutoMigration即可。
/* Copyright 2020 Google LLC. SPDX-License-Identifier: Apache-2.0 */@Database(
- version = 2,
+ version = 3,entities = [ Doggos.class ],autoMigrations = [AutoMigration (from = 1, to = 2),
+ AutoMigration (from = 2, to = 3)])
abstract class DoggosDatabase : RoomDatabase { }
针对在 @Database schema 中声明的实体,如添加新列或表,更新主键、外键或索引,或更改列的默认值,Room 会自动检测出这些变化,不需要额外介入。
需要注意的是: 从实现层面来说,Room 的自动迁移依赖于所生成的数据库 schema,因此在使用 autoMigrations 时,请确保 @Database 中的 exportSchema 选项为 true。否则将导致错误: Cannot create auto-migrations when export schema is OFF。
2,自动迁移需要帮助时
Room 的自动迁移无法检测到数据库上执行的所有可能的变化,因此有时候它们需要一些帮助。举一个常见的例子,Room 没办法检测到一个数据库表或列是否被重命名或者被删除。在这种情况下,Room 会抛出一个编译错误,并要求您实现 AutoMigrationSpec。此类允许您指定做出更改的类型,实现一个 AutoMigrationSpec 并使用以下一项或多项来注解:
- @DeleteTable(tableName)
- @RenameTable(fromTableName, toTableName)
- @DeleteColumn(tableName, columnName)
- @RenameColumn(tableName, fromColumnName, toColumnName)
举个例子,假设我们将 Doggos 的数据库表重命名为 GoodDoggos。Room 无法检测到我们是新建了这个表并删除了 Doggos 表,还是重命名了它以及要保留所有的值。那么此时,我们就需要使用RenameTable注解进行标识。
/* Copyright 2020 Google LLC. SPDX-License-Identifier: Apache-2.0 */@Database(version = 2,entities = [ GoodDoggos.class ],autoMigrations = [AutoMigration (from = 1, to = 2,spec = DoggosDatabase.DoggosAutoMigration::class)]
)
abstract class DoggosDatabase : RoomDatabase { @RenameTable(fromTableName = "Doggos", toTableName = "GoodDoggos")class DoggosAutoMigration: AutoMigrationSpec { }
}
3,何时使用迁移功能
针对手动迁移数据库 (manually handle migrations),Room 从 1.0 版本开始就提供了 Migration 类。每当您要更改复杂的数据库 Schema 时,您就得使用这个类。举例来说,假如我们决定将数据库中的一个表拆分成两个不同的表,Room 无法检测到拆分的执行过程,也不能自动检测到需要移动的数据。因此这个时候,您需要实现一个 Migration 类,并通过 addMigrations() 的方法将其添加至 databaseBuilder() 中。
/* Copyright 2020 Google LLC. SPDX-License-Identifier: Apache-2.0 */val MIGRATION_1_2 = object : Migration(1, 2) {override fun migrate(database: SupportSQLiteDatabase) {...}
}Room.databaseBuilder(applicationContext, DoggosDatabase::class.java, "doggos-database").addMigrations(MIGRATION_1_2,).build()
4,组合使用迁移与自动迁移
Room 允许将迁移与自动迁移结合起来使用。比如说,从版本 1 迁移到版本 2 可以通过 Migration来完成,版本 2 迁移到 3 则可以使用自动迁移。如果您在同一个版本上同时定义了 Migration 和自动迁移,那么只有 Migration 会生效。
在底层实现上,自动迁移会构建一个 Migration 类,因此 这篇文章 详细提到的迁移逻辑依然适用。TL;DR: 当数据库被首次访问时,Room 会检查当前的数据库版本是否与 @Database 中定义的版本不同。如是,Room 会寻找出从此到彼的迁移路径,届时会连续地执行迁移操作。
5,测试自动迁移
可以通过 MigrationTestHelper 的测试规则来测试自动迁移,并与使用 Migration 类相同的方式调用 helper.runMigrationsAndValidate()。
参考链接:https://developer.android.google.cn/training/data-storage/room/migrating-db-versions
Room 中的数据库迁移相关推荐
- Flask 中的数据库迁移
Flask 中的数据库迁移 在我之前使用 Flask 实现简单接口时,为了方便,我每次都会将数据表删除掉,然后重新创建表和添加数据.因为测试数据只有几条,所以可以使用删表重建的方式,但在实际的项目中, ...
- python数据库迁移教程_django中的数据库迁移的实现
Django是用python写的web开发框架,其特点是: 1.重量级框架,内部封装了很多的功能组件,使开发变的简便快速, 2.MVT模式:前后端分离,高内聚低耦合,m:model,与mvc中的m功能 ...
- laravel 框架中使用数据库迁移添加注释
laravel 框架中数据库迁移添加注释 在使用laravel框架过程中,估计很多人都有用过数据库迁移文件.可能大家都会在建表时为字段添加注释.我在此要说明的是为表添加注释 首先我们需要引入larav ...
- flyway数据迁移_使用Flyway在Java EE中进行数据库迁移
flyway数据迁移 任何Java EE应用程序的数据库模式都会随着业务逻辑一起发展. 这使得数据库迁移对于任何Java EE应用程序都很重要. 您是否还在执行应用程序时手动执行它们? 它仍然是一个锁 ...
- 使用Flyway在Java EE中进行数据库迁移
任何Java EE应用程序的数据库模式都会随着业务逻辑一起发展. 这使得数据库迁移对于任何Java EE应用程序都非常重要. 您是否还在执行应用程序时手动执行它们? 它仍然是一个锁定步骤过程,还是作为 ...
- 在Django中进行数据库迁移
1修改数据库的配置 如果使用默认数据库,则可以不用修改.如果使用 mysql 数据库,则打开 settings.py 文件,修改 DATABASES 项. 2.使用MySQL数据库,还需要在__ini ...
- 简单分析Flask 数据库迁移详情
本文给大家分享的是 Flask 数据库迁移详情,db.create_all()不会重新创建表或是更新表,需要先使用db.drop_all()删除数据库中所有的表之后再调用db.create_all() ...
- SQL Server数据库迁移–将数据库克隆到另一个排序规则
Database migration is a vital task in any environment, complex or otherwise. Seamless migrations are ...
- 关系型数据库迁移达梦数据库
前言 本文章描述对于金融机构纷纷转用国产数据库进行市场调研,在业务背景中做了粗略说明.同时详细介绍达梦数据库特性和优势.在项目中通常会使用第三方组件,在文章中以Flowable为例提供了解决方案. 业 ...
最新文章
- 《用Python进行自然语言处理》第2章 获得文本语料和词汇资源
- 清除memcached缓存数据的方式
- react router 级联路由_前端路由原理解析和实现
- HTMLCSS编码规范
- 每日小记2017.2.20
- 学习OpenCV时 ,添加:#includeopencv2/core/core.hpp等头文件出现无法编译的错误
- oracle procedure可以执行非常复杂的语句吗,oracle-存储过程(procedure)
- 向国外投稿需要注意些下面几点
- python撤回快捷键大全_Python基础之PyCharm快捷键大全
- eclipse优化设置
- 计算机毕业设计之java+ssm超市订单管理系统
- 玩转GD32F3x0开发板 (二)
- 银行金融计算机考试成绩查询系统,速看!人民银行成绩出了!戳进查分数+看排名!...
- 晒弟弟考取的教资证写的朋友圈文案
- 中国智能手机市场大幅衰退,仅华为vivo取得增长
- windows下操作Nginx基本命令
- 软件开发一般学什么?
- 软件测试 白盒测试 语句覆盖 判定覆盖
- 电脑文件软件搬家迁移十大工具
- (附源码)springboot智慧幼儿园管理系统的设计与实现 毕业设计271611
热门文章
- 惠普HP LaserJet M1120 一体机驱动
- JavaScript本地储存:localStorage、sessionStorage、cookie
- JS本地存储localStorage封装
- vue导出pdf文件
- 飞信失利后,咪咕视频能否帮中国移动踢进一球?
- 让代码提升一个逼格的代码命名
- 关于Servlet中注解:@WebServlet注解一直报错的解决办法
- Linux--实现一个简易的Shell(可以获取命令提示符,支持管道)
- pip 报错Traceback (most recent call last):
- Serverless:微服务架构的终极模式