mongodb数据库迁移变更的解决方案

前言

在版本迭代过程中，存在数据库变更的几率，如增加某张表某个字段，删除某个字段等；

缺乏变更历史的记录，要么在升级多套不同版本环境时，需要耗费大量时间去寻找数据库变更记录以及执行脚本；

该方案提供一种数据库变更记录方式；

使用到开源库：migrate，目前已经支持多种不同类型数据库（可视化目前使用的为mongodb，已经支持）；

使用

migrate提供两种方式进行变更操作：1. 命令行方式 2. SDK方式（使用Go)

在本方案中使用的为命令行方式(官方文档)。

安装

通过GitHub下载最新二进制文件包： github.com/golang-migr…

直接解压则可以使用；

简单使用

每一次数据库的变更都分为两种情况：up（升级版本）和down（降级版本）；

所以每一次变更记录的编写都需要两个文件，

				?

									{version}_{title}.up.{extension}

									{version}_{title}.down.{extension}

version为当前的版本号，可使用顺序序号或者时间戳进行表示，程序会对第一个'_'前的字符当成版本号；

title用于记录当前的变更的主题，主要是对用户有较好的提示作用；

extension：表示文件扩展名；

举例如mongodb数据库：

				?

									0001_init_database.down.json  

									0001_init_database.up.json

在创建迁移文件时，可以使用migrate create 命令进行创建，如

				?

									# migrate create [-ext E] [-dir D] [-seq] [-digits N] [-format] NAME

									$ migrate create -ext json -dir migrations -seq init_database

									~/migrations/000001_init_database.up.json

									~/migrations/000001_init_database.down.json

参数介绍：

ext: 文件扩展名；
dir: 创建的目录；
seq: 是否以序号模式进行创建；
digits: 序号长度（默认为6）；
format：时间格式。

使用该文件对mirations数据库中的test集合，进行初始化操作；

				?

									$ cat migrations/000001_init_database.up.json

									[

									    {

									       "insert": "test",

									       "documents": [{"name": "aaa"}]

									    }

									]

									$migrate -verbose -source file://migrations --database mongodb://root:pwd@<数据库IP>:27017/migrations?authSource=admin  up

									2021/08/31 14:26:06 Start buffering 1/u init_database

									2021/08/31 14:26:08 Read and execute 1/u init_database

									2021/08/31 14:26:08 Finished 1/u init_database (read 1.516025172s, ran 75.143261ms)

									2021/08/31 14:26:08 Finished after 1.654028624s

									2021/08/31 14:26:08 Closing source and database

参数解释：

verbose：打印当前变更日志
source：变更文件存放目录，最好进入本项目的migrations目录下执行，使用ls可查看当前所有数据库
database: 为monogdb连接uri
up：升级（使用 down 降级）

查看数据库，发现数据已经插入到了数据库中：

				?

									mongos> use migrations;

									switched to db migrations

									mongos> show collections;

									migrate_advisory_lock

									schema_migrations

									test

									mongos> db.test.find()

									{ "_id" : ObjectId("612e3f5febb6de55cdeec1de"), "name" : "aaa" }

									# 多生成了两张表，其中schema_migrations为迁移数据记录;

									mongos> db.schema_migrations.find();

									{ "_id" : ObjectId("612dcb8023fbb5b85368b874"), "version" : 1, "dirty" : false }

修改version能够控制migrate的升级版本；当本身数据库的版本已经高于最新版本时，可以使用force命令，修改当前数据库迁移的版本号；

				?

									$ migrate -verbose -source file://migrations --database mongodb://root:pwd@<数据库IP>:27017/migrations?authSource=admin force 000004

									2021/08/31 14:34:52 Finished after 89.470244ms

									2021/08/31 14:34:52 Closing source and database

									# 查看数据库版本已经修改到了4版本，再次进行up操作则会被告知no change；

									mongos> db.schema_migrations.find();

									{ "_id" : ObjectId("612dcd8c1e88c95afcb426fe"), "version" : 4, "dirty" : false }