数据库结构变更
Database schema migration，数据库变更，是根据你的应用程序数据模型的变化更新数据库 schema 的过程。
Jmix 使用 Liquibase 作为数据库变更工具。
工作流程
Jmix Studio 将 JPA 实体 的当前状态和相应 数据存储 的数据库 schema 进行比较，然后以 Liquibase changelog 的格式创建变更脚本。当你使用 Run/Debug Configuration 启动应用程序 时，会自动执行这个过程。changelog 保存在应用程序的源代码中，并构建到二进制制品中。
| 还可以通过修改 Run/Debug configuration 设置禁用自动创建变更脚本的功能。 |
当应用程序启动时，会使用 Liquibase 运行生成的 changelog 以更新连接的数据库。
| 你还可以随时使用 Generate Liquibase Changelog 操作 创建 changelog ，并在 Studio 的 Jmix tool 窗口中对数据存储执行 Update 操作。 |
主程序所依赖的扩展组件也可以包含 Liquibase changelog 文件。组件的 changelog 会在主程序的 changelog 之前运行。
changelog 文件结构
Studio 在应用程序项目的 src/main/resources/<base_package>/liquibase 目录下生成 changelog 文件。在此目录中，Studio 为主数据存储创建 changelog 目录，并为附加数据存储创建 <store>-changelog 目录。Changelog 文件创建在以与当前日期的年月命名的子目录下。文件名包括日期、当天的序列号和一个随机字符序列，以避免多个开发人员在同一个项目上工作时发生冲突。
├── liquibase/ (1)
│ ├── changelog/ (2)
│ │ ├── 010-init-user.xml (3)
│ │ └── 2020/
│ │ ├── 11/
│ │ │ ├── 12-010-fe2b82e6.xml (4)
│ │ │ └── 27-010-fe2b82e6.xml
│ │ └── 12/
│ │ └── 17-010-fe2b82e6.xml
│ ├── changelog.xml (5)
│ ├── locations-changelog/ (6)
│ │ └── 2020/
│ │ └── 11/
│ │ ├── 25-010-fe2b82e6.xml
│ │ └── 28-010-fe2b82e6.xml
│ └── locations-changelog.xml (7)| 1 | Liquibase changelog 文件结构的根目录。 |
| 2 | 主数据存储的 changelog 目录。 |
| 3 | 为新项目提供的 changelog 文件。为 User 实体创建一个表。 |
| 4 | Studio 生成的 changelog 文件。 |
| 5 | 主数据存储的 root changelog 文件。 |
| 6 | locations 数据存储的 changelog 目录。 |
| 7 | locations 数据存储的 root changelog 文件。 |
对于每个数据存储，在 src/main/resources/<base_package>/liquibase 目录中都有一个 root changelog 文件。其中有一个指令用来包含在 changelog 子目录下所有的 changelog 文件。项目中必须带有 <data-store-name>.liquibase.change-log 配置，其值为 root changlog 的路径，示例：
main.liquibase.change-log = com/company/demo/liquibase/changelog.xml主数据存储的 root Liquibase changelog 中有 include 指令，用于包含项目中所有扩展组件的 changelog。因此，这样的 changelog 能兼容 Liquibase Gradle 插件 和 Liquibase CLI，并支持在没有 Studio 或者应用程序的环境中运行 Liquibase，例如，在 CI 服务器上。
在添加或删除扩展组件时，Studio 能自动维护 changelog 中的引用关系。还有，当启动应用程序时，Studio 还会检查 root changelog 中的引用是否与项目使用的组件匹配。如果发现不匹配，Studio 会显示通知弹窗，建议添加或删除一些引用。这里可以忽略某些路径，之后的通知中就不会再次显示已经忽略的条目。
可以手动编写 Liquibase changelog 文件并将它们放入上述结构中。Liquibase 按带有整个路径的字母顺序执行包含的 changelog ，因此，需要为自定义文件设置合适的文件名。
切勿删除 root changelog.xml 文件，这是启动变更过程必需的文件。此外，除非你想以非标准方式实现安全性，否则不要删除 changelog/010-init-user.xml。
|
| 可以使用 Jmix Studio 中数据存储 右键菜单 的 Aggregate Liquibase Changelogs 操作将多个最近生成的 changelog 合并为一个。 |
配置 Liquibase
可以按照 Spring Boot 文档（参见 spring.liquibase. 属性）中相同的方式在 application.properties 中为主数据存储设置 Liquibase 属性（参见 spring.liquibase. 属性），但需要将 spring.liquibase 前缀替换为 main.liquibase，例如：
main.liquibase.enabled = false对于 附加数据存储，将应用程序属性中的 main 替换为此数据存储的名称。
|
|
默认情况下，Jmix Studio 会将数据库中的所有表与数据模型进行比较，并生成数据库变更脚本，脚本中对无法找到对应实体类的数据库表还会生成 DROP TABLE 语句。如果你的数据库包含无法与实体对应的表，可以将表格前缀或完整名称添加到 main.datasource.studio.liquibase.exclude-prefixes 应用程序属性，这样可以忽略这些表，例如：
main.datasource.studio.liquibase.exclude-prefixes = abc_,foo,bar