# springboot2.5.0

# 重新设计的 spring.sql.init 配置有啥用(SQL Script DataSource Initialization)

先来看看这次被弃用部分的内容（位于org.springframework.boot.autoconfigure.jdbc.DataSourceProperties）
对应到配置文件里的属性如下

spring.datasource.schema=
spring.datasource.schema-username=
spring.datasource.schema-password=

1
2
3

Spring Boot 2.5.0 开始，启用了全新的配置方式，我们可以从这个类org.springframework.boot.autoconfigure.sql.init.SqlInitializationProperties里看到详情。

下面我们通过一个简单的例子来体验这个功能的作用。

创建一个 Spring Boot 的基础应用，并在 pom.xml 中引入和 mysql 的依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

1
2
3
4
5
6
7
8
9

在配置文件中增加数据源和初始化数据源的配置，具体如下：

spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# Spring Boot 2.5.0 init schema & data
# 执行初始化脚本的用户名称
spring.sql.init.username=root
# 执行初始化脚本的用户密码
spring.sql.init.password=
# 初始化的schema脚本位置
spring.sql.init.schema-locations=classpath*:schema-all.sql

1
2
3
4
5
6
7
8
9
10
11
12

根据上面配置的定义，接下来就在 resource 目录下，创建脚本文件schema-all.sql，并写入一些初始化表结构的脚本

create table test.user_info
(
    id          int unsigned auto_increment comment '用户id' primary key,
    open_id     varchar(255)     default '' null comment '微信小程序openid',
    nick_name   varchar(255)     default '' null comment '微信名',
    head_img    varchar(255)     default '' null comment '微信头像',
    sex         varchar(255)     default '' null comment '性别',
    phone       varchar(255)     default '' null comment '手机',
    province    varchar(255)     default '' null comment '注册地址：省',
    city        varchar(255)     default '' null comment '注册地址：城市',
    country     varchar(255)     default '' null comment '注册地址：县/区',
    status      tinyint unsigned default 0  not null comment '是否标记删除 0：否 1：是',
    create_time datetime                    not null comment '创建时间',
    update_time datetime                    not null comment '更新时间'
)
comment '用户表';

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

完成上面步骤之后，启动应用。然后打开MySQL客户端，可以看到在test库下，多了一个user_info表

# 配置详解

除了上面用到的配置属性之外，还有一些其他的配置，下面详细讲解一下作用。

spring.sql.init.enabled：是否启动初始化的开关，默认是true。如果不想执行初始化脚本，设置为false即可。通过-D的命令行参数会更容易控制。
spring.sql.init.username和spring.sql.init.password：配置执行初始化脚本的用户名与密码。这个非常有必要，因为安全管理要求，通常给业务应用分配的用户对一些建表删表等命令没有权限。这样就可以与datasource中的用户分开管理。
spring.sql.init.schema-locations：配置与schema变更相关的sql脚本，可配置多个（默认用;分割）
spring.sql.init.data-locations：用来配置与数据相关的sql脚本，可配置多个（默认用;分割）
spring.sql.init.encoding：配置脚本文件的编码
spring.sql.init.separator：配置多个sql文件的分隔符，默认是;
spring.sql.init.continue-on-error：如果执行脚本过程中碰到错误是否继续，默认是false`；所以，上面的例子第二次执行的时候会报错并启动失败，因为第一次执行的时候表已经存在。