数据库初始化

SQL 数据库的初始化方式因技术栈而异。当然，如果数据库是独立进程，您也可以手动进行初始化。建议使用单一机制进行模式生成。

使用 Hibernate 初始化数据库

您可以设置 spring.jpa.hibernate.ddl-auto 来控制 Hibernate 的数据库初始化。支持的值包括 none、validate、update、create 和 create-drop。Spring Boot 会根据您是否使用嵌入式数据库为您选择一个默认值。嵌入式数据库通过检查 Connection 类型和 JDBC URL 来识别。hsqldb、h2 或 derby 是嵌入式数据库，其他则不是。如果识别出嵌入式数据库且未检测到模式管理器（Flyway 或 Liquibase），则 ddl-auto 默认为 create-drop。在所有其他情况下，它默认为 none。

从内存数据库切换到“真实”数据库时，请务必小心，不要假定新平台中表和数据的存在。您必须显式设置 ddl-auto 或使用其他机制来初始化数据库。

您可以通过启用 org.hibernate.SQL 记录器来输出模式创建。如果您启用调试模式，此操作会自动为您完成。

此外，如果 Hibernate 从头开始创建模式（即，如果 ddl-auto 属性设置为 create 或 create-drop），则在启动时会执行 classpath 根目录中名为 import.sql 的文件。这对于演示和测试非常有用，但您在生产环境中可能不希望它在 classpath 中。这是一个 Hibernate 功能（与 Spring 无关）。

使用基本 SQL 脚本初始化数据库

Spring Boot 可以自动创建您的 JDBC DataSource 或 R2DBC ConnectionFactory 的模式（DDL 脚本）并初始化其数据（DML 脚本）。

默认情况下，它从 optional:classpath*:schema.sql 加载模式脚本，并从 optional:classpath*:data.sql 加载数据脚本。这些模式和数据脚本的位置可以分别使用 spring.sql.init.schema-locations 和 spring.sql.init.data-locations 进行自定义。optional: 前缀表示即使文件不存在，应用程序也会启动。要让应用程序在文件不存在时启动失败，请删除 optional: 前缀。

此外，Spring Boot 会处理 optional:classpath*:schema-${platform}.sql 和 optional:classpath*:data-${platform}.sql 文件（如果存在），其中 ${platform} 是 spring.sql.init.platform 的值。这允许您在必要时切换到特定于数据库的脚本。例如，您可以选择将其设置为数据库的供应商名称（hsqldb、h2、oracle、mysql、postgresql 等）。

默认情况下，SQL 数据库初始化仅在使用嵌入式内存数据库时执行。要始终初始化 SQL 数据库，无论其类型如何，请将 spring.sql.init.mode 设置为 always。同样，要禁用初始化，请将 spring.sql.init.mode 设置为 never。默认情况下，Spring Boot 启用其基于脚本的数据库初始化器的快速失败功能。这意味着如果脚本导致异常，应用程序将启动失败。您可以通过设置 spring.sql.init.continue-on-error 来调整此行为。

默认情况下，基于脚本的 DataSource 初始化在创建任何 JPA EntityManagerFactory bean 之前执行。schema.sql 可用于为 JPA 管理的实体创建模式，data.sql 可用于填充数据。虽然我们不建议使用多种数据源初始化技术，但如果您希望基于脚本的 DataSource 初始化能够基于 Hibernate 执行的模式创建，请将 spring.jpa.defer-datasource-initialization 设置为 true。这将推迟数据源初始化，直到任何 EntityManagerFactory bean 已创建并初始化。然后，schema.sql 可用于对 Hibernate 执行的任何模式创建进行补充，data.sql 可用于填充数据。

初始化脚本支持 -- 用于单行注释，/* */ 用于块注释。不支持其他注释格式。

如果您正在使用 更高级别的数据库迁移工具，例如 Flyway 或 Liquibase，您应该单独使用它们来创建和初始化模式。不建议将基本的 schema.sql 和 data.sql 脚本与 Flyway 或 Liquibase 一起使用，并且在将来的版本中将移除此支持。

如果您需要使用更高级别的数据库迁移工具初始化测试数据，请参阅有关 Flyway 和 Liquibase 的部分。

初始化 Spring Batch 数据库

如果您使用 Spring Batch，它预先打包了适用于大多数流行数据库平台的 SQL 初始化脚本。Spring Boot 可以检测您的数据库类型并在启动时执行这些脚本。如果您使用嵌入式数据库，这默认会发生。您也可以为任何数据库类型启用它，如以下示例所示

  • 属性

  • YAML

spring.batch.jdbc.initialize-schema=always
spring:
  batch:
    jdbc:
      initialize-schema: "always"

您也可以通过将 spring.batch.jdbc.initialize-schema 设置为 never 来显式关闭初始化。

使用更高级别的数据库迁移工具

Spring Boot 支持两种更高级别的迁移工具：Flyway 和 Liquibase。

在启动时执行 Flyway 数据库迁移

要在启动时自动运行 Flyway 数据库迁移，请将相应的 Flyway 模块添加到您的 classpath。内存数据库和基于文件的数据库支持 org.flywaydb:flyway-core。否则，需要一个特定于数据库的模块。例如，将 org.flywaydb:flyway-database-postgresql 与 PostgreSQL 一起使用，将 org.flywaydb:flyway-mysql 与 MySQL 一起使用。有关更多详细信息，请参阅 Flyway 文档。

通常，迁移是格式为 V<VERSION>__<NAME>.sql 的脚本（其中 <VERSION> 是一个以下划线分隔的版本，例如 '1' 或 '2_1'）。默认情况下，它们位于名为 classpath:db/migration 的目录中，但您可以通过设置 spring.flyway.locations 来修改该位置。这是一个逗号分隔的一个或多个 classpath: 或 filesystem: 位置列表。例如，以下配置将在默认 classpath 位置和 /opt/migration 目录中搜索脚本

  • 属性

  • YAML

spring.flyway.locations=classpath:db/migration,filesystem:/opt/migration
spring:
  flyway:
    locations: "classpath:db/migration,filesystem:/opt/migration"

您还可以添加一个特殊的 {vendor} 占位符以使用特定于供应商的脚本。假设以下

  • 属性

  • YAML

spring.flyway.locations=classpath:db/migration/{vendor}
spring:
  flyway:
    locations: "classpath:db/migration/{vendor}"

前面的配置不使用 db/migration，而是根据数据库类型（例如 MySQL 的 db/migration/mysql）设置要使用的目录。DatabaseDriver 中提供了受支持的数据库列表。

迁移也可以用 Java 编写。Flyway 将自动配置任何实现 JavaMigration 的 bean。

FlywayProperties 提供了 Flyway 的大部分设置以及一小部分可用于禁用迁移或关闭位置检查的附加属性。如果您需要对配置进行更多控制，请考虑注册一个实现 FlywayConfigurationCustomizer 的 bean。

Spring Boot 调用 Flyway.migrate() 执行数据库迁移。如果您需要更多控制，请提供一个实现 FlywayMigrationStrategy 的 @Bean。

Flyway 支持 SQL 和 Java 回调。要使用基于 SQL 的回调，请将回调脚本放在 classpath:db/migration 目录中。要使用基于 Java 的回调，请创建一个或多个实现 Callback 的 bean。任何此类 bean 都会自动注册到 Flyway。它们可以通过使用 @Order 或实现 Ordered 进行排序。

默认情况下，Flyway 会自动装配您上下文中的（@Primary）DataSource 并将其用于迁移。如果您希望使用不同的 DataSource，您可以创建一个并将其 @Bean 标记为 @FlywayDataSource。如果您这样做并且需要两个数据源（例如保留主要自动配置的 DataSource），请记住将 @Bean 注解的 defaultCandidate 属性设置为 false。或者，您可以通过在外部属性中设置 spring.flyway.[url,user,password] 来使用 Flyway 的原生 DataSource。设置 spring.flyway.url 或 spring.flyway.user 中的任何一个都足以使 Flyway 使用自己的 DataSource。如果这三个属性中的任何一个未设置，将使用其对应的 spring.datasource 属性的值。

您还可以使用 Flyway 为特定场景提供数据。例如，您可以将测试特定的迁移放在 src/test/resources 中，并且它们仅在您的应用程序启动进行测试时运行。此外，您可以使用特定于配置文件的配置来自定义 spring.flyway.locations，以便某些迁移仅在特定配置文件处于活动状态时运行。例如，在 application-dev.properties 中，您可以指定以下设置

  • 属性

  • YAML

spring.flyway.locations=classpath:/db/migration,classpath:/dev/db/migration
spring:
  flyway:
    locations: "classpath:/db/migration,classpath:/dev/db/migration"

通过此设置，dev/db/migration 中的迁移仅在 dev 配置文件处于活动状态时运行。

在启动时执行 Liquibase 数据库迁移

要在启动时自动运行 Liquibase 数据库迁移，请将 org.liquibase:liquibase-core 添加到您的 classpath。

当您将 org.liquibase:liquibase-core 添加到 classpath 时，数据库迁移默认会在应用程序启动期间和测试运行之前运行。此行为可以通过使用 spring.liquibase.enabled 属性，在 main 和 test 配置中设置不同的值来定制。不能使用两种不同的方式来初始化数据库（例如，应用程序启动使用 Liquibase，测试运行使用 JPA）。

默认情况下，主变更日志从 db/changelog/db.changelog-master.yaml 读取，但您可以通过设置 spring.liquibase.change-log 来更改位置。除了 YAML，Liquibase 还支持 JSON、XML 和 SQL 变更日志格式。

默认情况下，Liquibase 会自动装配您上下文中的（@Primary）DataSource 并将其用于迁移。如果您希望使用不同的 DataSource，您可以创建一个并将其 @Bean 标记为 @LiquibaseDataSource。如果您这样做并且需要两个数据源（例如保留主要自动配置的 DataSource），请记住将 @Bean 注解的 defaultCandidate 属性设置为 false。或者，您可以通过在外部属性中设置 spring.liquibase.[driver-class-name,url,user,password] 来使用 Liquibase 的原生 DataSource。设置 spring.liquibase.url 或 spring.liquibase.user 中的任何一个都足以使 Liquibase 使用自己的 DataSource。如果这三个属性中的任何一个未设置，将使用其对应的 spring.datasource 属性的值。

有关可用设置（例如上下文、默认模式等）的详细信息，请参阅 LiquibaseProperties。

如果您想在使用 Liquibase 实例之前对其进行自定义，您还可以使用 Customizer<Liquibase> bean。

将 Flyway 用于仅测试迁移

如果您想创建 Flyway 迁移来填充您的测试数据库，请将它们放在 src/test/resources/db/migration 中。例如，一个名为 src/test/resources/db/migration/V9999__test-data.sql 的文件将在您的生产迁移之后执行，并且仅在您运行测试时执行。您可以使用此文件创建所需的测试数据。此文件不会打包在您的 uber jar 或容器中。

将 Liquibase 用于仅测试迁移

如果您想创建 Liquibase 迁移来填充您的测试数据库，您必须创建一个测试变更日志，其中也包含生产变更日志。

首先，您需要配置 Liquibase 在运行测试时使用不同的变更日志。一种方法是创建一个 Spring Boot test 配置文件并将 Liquibase 属性放在其中。为此，请创建一个名为 src/test/resources/application-test.properties 的文件，并在其中放置以下属性

  • 属性

  • YAML

spring.liquibase.change-log=classpath:/db/changelog/db.changelog-test.yaml
spring:
  liquibase:
    change-log: "classpath:/db/changelog/db.changelog-test.yaml"

这将配置 Liquibase 在 test 配置文件中运行时使用不同的变更日志。

现在在 src/test/resources/db/changelog/db.changelog-test.yaml 创建变更日志文件

databaseChangeLog:
  - include:
      file: classpath:/db/changelog/db.changelog-master.yaml
  - changeSet:
      runOrder: "last"
      id: "test"
      changes:
        # Insert your changes here

此变更日志将在运行测试时使用，并且不会打包在您的 uber jar 或容器中。它包含生产变更日志，然后声明一个新的变更集，其 runOrder: last 设置指定它在所有生产变更集运行后运行。您现在可以使用例如 插入变更集 插入数据或 sql 变更集 直接执行 SQL。

最后一步是配置 Spring Boot 以在运行测试时激活 test 配置文件。为此，您可以将 @ActiveProfiles("test") 注解添加到您的 @SpringBootTest 注解的测试类中。

依赖已初始化的数据库

数据库初始化在应用程序启动时作为应用程序上下文刷新的一部分执行。为了允许在启动期间访问已初始化的数据库，会自动检测充当数据库初始化器的 bean 和需要数据库已初始化的 bean。其初始化依赖于数据库已初始化的 bean 被配置为依赖于初始化它的 bean。如果在启动期间，您的应用程序尝试访问数据库且尚未初始化，您可以配置对初始化数据库并需要数据库已初始化的 bean 的额外检测。

检测数据库初始化器

Spring Boot 将自动检测以下初始化 SQL 数据库的 bean 类型

如果您正在使用第三方数据库初始化库的 starter，它可能会提供一个检测器，以便其他类型的 bean 也能自动检测到。要检测其他 bean，请在 META-INF/spring.factories 中注册 DatabaseInitializerDetector 的实现。

检测依赖数据库初始化的 Bean

Spring Boot 将自动检测以下依赖数据库初始化的 bean 类型

如果您正在使用第三方数据访问库的 starter，它可能会提供一个检测器，以便其他类型的 bean 也能自动检测到。要检测其他 bean，请在 META-INF/spring.factories 中注册 DependsOnDatabaseInitializationDetector 的实现。或者，使用 @DependsOnDatabaseInitialization 注解 bean 的类或其 @Bean 方法。

© . This site is unofficial and not affiliated with VMware.