数据库迁移

[[toc]]

简介

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

生成迁移

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

go run . artisan make:migration create_users_table

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

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

执行迁移

执行 Artisan 命令 migrate，来运行所有未执行过的迁移：

go run . artisan migrate

如果你想查看目前的迁移状态，可以使用 migrate:status Artisan 命令：

go run . artisan migrate:status

回滚迁移

如果要回滚最后一次迁移操作，可以使用 Artisan 命令 rollback。该命令会回滚最后「一批」的迁移，这可能包含多个迁移文件：

go run . artisan migrate:rollback

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

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

命令 migrate:reset 会回滚应用已运行过的所有迁移：

go run . artisan migrate:reset

使用单个命令同时进行回滚和迁移操作

命令 migrate:refresh 首先会回滚已运行过的所有迁移，随后会执行 migrate。这一命令可以高效地重建你的整个数据库：

go run . artisan migrate:refresh

通过在命令 refresh 中使用 step 参数，你可以回滚并重新执行指定数量的迁移操作。例如，下列命令会回滚并重新执行最后五个迁移操作：

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

删除所有表然后执行迁移

命令 migrate:fresh 会删去数据库中的所有表，随后执行命令 migrate：

go run . artisan migrate:fresh

快捷生成

使用 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+)$

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