数据库迁移

简介

当多人协作开发应用程序时,如果同步数据库结构没有一个统一的规范,以保证所有人的本地数据都是一致的,那将是灾难。数据库迁移就是为了解决这个问题,将数据库的结构进行版本控制,以保证所有开发人员的数据库结构的一致性。

生成迁移

使用 make:migration 命令来创建迁移:

go run . artisan make:migration create_users_table

该命令会在 database/migrations 目录下生成迁移文件,所有迁移文件都以一个时间戳为开头,Goravel 将以此作为迁移文件的执行顺序。所有的迁移文件都是 .sql 文件,你可以使用 SQL 语句自定义表结构。

迁移命令会同时生成两个迁移文件:***.up.sql***.down.sql,分别对应执行、回滚。

运行迁移

go run . artisan migrate

快捷生成

使用 create_users_table 将会自动生成包含 users 基础结构的表:

CREATE TABLE users (
  id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
  created_at datetime(3) DEFAULT NULL,
  updated_at datetime(3) DEFAULT NULL,
  PRIMARY KEY (id),
  KEY idx_users_created_at (created_at),
  KEY idx_users_updated_at (updated_at)
) ENGINE = InnoDB AUTO_INCREMENT = 1 DEFAULT CHARSET = DummyDatabaseCharset;

实现原理是根据正则进行匹配:

^create_(\w+)_table$
^create_(\w+)$

使用 add_avatar_to_users_table 将会自动生成向 users 表增加字段的结构:

ALTER TABLE users ADD column varchar(255) COMMENT '';

实现原理是根据正则进行匹配:

_(to|from|in)_(\w+)_table$
_(to|from|in)_(\w+)$

未匹配到上述情况时,框架会生成一个空的迁移文件。

回滚迁移

如果要回滚最后一次迁移操作,可以使用 Artisan 命令 rollback。注意,该命令只会回滚最后一个迁移文件:

go run . artisan migrate:rollback

通过向 rollback 命令加上 step 参数,可以回滚指定数量的迁移。例如,以下命令将回滚最后五个迁移文件:

go run . artisan migrate:rollback --step=5