写给.NET开发者的数据库Migration方案

小程序：扫一扫查出行
【扫一扫了解最新限行尾号】
复制小程序

微软给我们提供了一种非常好用的数据库迁移方案，但是我发现周围的同学用的并不多，所以我还是想把这个方案整理一下。.NET选手看过来，特别是还在通过手工执行脚本来迁移数据库的同学们，当然你也可以选择EF的Migration方案和FluentMigrator，但是下面我介绍的这种方案符合我对团队协作的所有要求，对开发者而言使用起来非常方便，不容易犯错。

一、方案目标

一个好的数据库迁移方案在我看来需要满足以下条件：

1、适用于每个开发者拥有自己独立的数据库开发环境，用于不同feature的并行开发

2、能够配合版本控制工具，不同的版本能够方便合并和易于解决冲突

3、数据库开发环境要易于在不同的版本之间切换

4、易于跟CI工具集成，不同的开发环境（Dev,QA,Staging,Product)能够部署不同的数据库开发环境

5、DBA能够方便审核开发人员提交的数据库脚本

6、整个数据库的迁移过程由脚本自动化完成，不应该有人工干涉

二、准备

假设我们有一个数据库blog，该数据库中包含一个表Users，数据库初始脚本：

Create Database Blog
GOUSE [Blog]
GO/****** Object: Table [dbo].[Users] Script Date: 2016/7/31 17:18:09 ******/
SET ANSI_NULLS ON
GOSET QUOTED_IDENTIFIER ON
GOCREATE TABLE [dbo].[Users](
[Id] [int] IDENTITY(1,1) NOT NULL,
[UserName] [nvarchar](200) NULL,
[Email] [nvarchar](100) NULL,
[Age] [int] NULL,
CONSTRAINT [PK_Users] PRIMARY KEY CLUSTERED
(
[Id] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
) ON [PRIMARY]GO

如图所示，我们得到了一个初始的数据库版本：

三、新建数据库迁移解决方案

1、打开vs，我用的是vs2015

2、如图所示，新建工程

3，在Blog.Database工程，右键，选择Schema Compare…

4、点击中间的“交换位置”图标，左边代表源(Source)，右边代表目标(Destination)。我们现在要本地数据库把schema更新在我们新建的数据库工程中。

5、在“源”中选择Select source

6、按照下图所示添加数据库连接

7、Compare 然后Update，数据库中的schema将会同步在我们的vs解决方案中

四、添加存储过程

至此为止我们已经添加了对Blog数据库的迁移方案，所有开发人员对数据库的更改都要通过该解决方案来完成。

比如开发者A这时候需要添加第一个存储过程：

1、在dbo目录下新建Stored Procedures文件夹

2、新建存储过程脚本GetUser.sql

编写以下存储过程：

-- =============================================
-- Author:<Author,,Name>
-- Create date: <Create Date,,>
-- Description:<Description,,>
-- =============================================
CREATE PROCEDURE GetUser
AS
BEGIN
-- SET NOCOUNT ON added to prevent extra result sets from
-- interfering with SELECT statements.
SET NOCOUNT ON; -- Insert statements for procedure here
SELECT TOP 100* FROM Users
END

脚本已经编写完毕，这时候开发者A需要把这个更改更新到本地的数据库中：

这时候“源”是我们的数据库迁移方案，目标是本机的数据库，compare然后update

以git为例，开发人员此时会把Blog.Database解决方案更改合并到develop分支，其他开发人员通过compare-update操作将别人对数据库的更改update到本地。

五、更改表结构

开发人员B在另一个分支需要对表User添加两列：Gender和Description，直接在解决方案中打开User表做更改

当然最后要通过Compare-Update操作将更改应用到本地数据库，其他开发人员也会通过相同的方式将此更改应用在本地。

六、添加Reference Data

开发人员添加了一个表Gender，并且需要添加三条固定数据：

在Tables文件夹下右键-Tabel-Gender

这时候需要添加三条固定数据:Male,Female,Unknown，这时候要用到PostDeploymentSql：

1、新建PostDeploymentSql

2、新建Gender.sql

3、（重要）此时要在Gender.sql右键，Builder Action-None，否则无法编译

4、在Gender.sql添加下面的Sql，这个sql在每次部署的时候都要执行，所以一定是“幂等”的：

PRINT 'Beginning Deployment Gender table...'IF EXISTS (select top 1 1 from dbo.Gender where Value='01')
update dbo.Gender set Name='Male' where Value='01'
else
insert dbo.Gender(value,Name) values('01','Male')IF EXISTS (select top 1 1 from dbo.Gender where Value='02')
update dbo.Gender set Name='Female' where Value='02'
else
insert dbo.Gender(value,Name) values('02','Female')IF EXISTS (select top 1 1 from dbo.Gender where Value='03')
update dbo.Gender set Name='Unknown' where Value='03'
else
insert dbo.Gender(value,Name) values('03','Unknown')PRINT 'Finishing Deployment Gender table...'

5、在Script.PostDeployment.sql中编写下面的脚本：

PRINT 'Running Post-Deploy Scripts'
:r .\Gender.sql
--append other sql scripts PRINT 'End Post-Deploy Scripts'

6、Compare-Update，将此更改更新到本地数据库

此时你会发现本地数据库添加了Gender表，但是我们添加的三条数据并没有进来，这是因为Script.PostDeployment.sql并没有执行，这个脚本只有在发布的时候才能执行。

七、添加publish文件

通过上面的步骤我们可以看出来，我们每次都是先更改数据库迁移解决方案，然后通过Compare和Update操作将更新同步到本地，但是这样操作存在两个缺点：

1、Script.PostDeployment.sql并没有执行，无法将ReferenceData同步在数据库

2、只适用于同步本地数据库，其他环境需要采用一些自动化的方式来完成，而不是手工compare,update，避免人工操作失误

通过下面的步骤来添加publish文件

1、在Blog.Database工程上右键-publish

接下来要添加数据库连接，然后添加Create Profile，最后点击publish。