Liquibase多租户场景：如何高效更新所有数据库Schema？

针对100个租户Schema的批量迁移需求，没必要为每个Schema单独创建临时容器，以下是几种更高效的单容器批量执行方案：

方案1：单容器内通过Shell脚本循环执行Liquibase命令 #

核心思路是在容器内运行自定义脚本，遍历所有租户的配置文件，逐个执行迁移命令。

步骤： #

1. 准备配置文件集合：

   • 为每个租户创建独立的liquibase-<schema-name>.properties配置文件，统一放在./configs/目录下
   • 创建schemas.list文件，每行对应一个配置文件名（如liquibase-tenant1.properties）

2. 编写迁移脚本：
   创建run-migrations.sh脚本，内容如下：

   #!/bin/bash
   set -eo pipefail
   
   # 遍历所有租户配置文件
   while read -r prop_file; do
     if [[ -f "/liquibase/configs/$prop_file" ]]; then
       echo "=== 开始执行Schema迁移：$prop_file ==="
       liquibase --defaultsFile="/liquibase/configs/$prop_file" update
       echo "=== Schema迁移完成：$prop_file ==="
     else
       echo "警告：配置文件不存在 - $prop_file"
     fi
   done < /liquibase/configs/schemas.list
   

   给脚本添加可执行权限：chmod +x run-migrations.sh

3. 修改容器配置：
   将脚本、配置文件目录挂载到容器中，替换原有命令为执行脚本：

   ...
     liquibase:
       image: "liquibase/liquibase:4.17.2"
       volumes:
         - ../migration:/liquibase/db/migration/
         - ./configs:/liquibase/configs/  # 挂载配置文件、脚本、schemas.list
       command: ["/bin/bash", "/liquibase/configs/run-migrations.sh"]
   ...
   

方案2：单配置文件+命令行参数动态指定Schema #

如果所有租户的数据库连接参数（除Schema外）都一致，可以不用多个配置文件，通过命令行参数动态覆盖Schema相关配置，减少冗余。

步骤： #

1. 准备基础配置文件：
   保留一个通用的liquibase.properties，只填公共参数：

   driver: com.mysql.cj.jdbc.Driver
   changeLogFile: db/migration/changelog.xml
   

2. 编写动态迁移脚本：
   创建run-migrations-dynamic.sh，遍历Schema名称列表，通过命令行指定URL和认证参数：

   #!/bin/bash
   set -eo pipefail
   
   # schemas.list里每行是租户Schema名称
   while read -r schema_name; do
     echo "=== 开始执行Schema迁移：$schema_name ==="
     # 根据数据库类型调整URL格式：MySQL用jdbc:mysql://host:port/$schema_name；PostgreSQL用?currentSchema=$schema_name
     liquibase \
       --defaultsFile=/liquibase/liquibase.properties \
       --url="jdbc:mysql://db-host:3306/$schema_name" \
       --username="$DB_USER" \
       --password="$DB_PASS" \
       update
     echo "=== Schema迁移完成：$schema_name ==="
   done < /liquibase/configs/schemas.list
   

3. 容器配置调整：
   挂载脚本、Schema列表和基础配置文件，同时传入数据库用户名密码的环境变量：

   ...
     liquibase:
       image: "liquibase/liquibase:4.17.2"
       volumes:
         - ../migration:/liquibase/db/migration/
         - ./configs:/liquibase/configs/
         - ./liquibase.properties:/liquibase/liquibase.properties
       environment:
         - DB_USER=your-db-user
         - DB_PASS=your-db-pass
       command: ["/bin/bash", "/liquibase/configs/run-migrations-dynamic.sh"]
   ...
   

注意事项 #

• 错误处理：脚本中加入set -eo pipefail可在某个Schema迁移失败时终止脚本；若需忽略错误继续执行，可移除该指令并手动判断命令返回码。
• 性能与资源：100个Schema串行执行耗时较长，若数据库支持，可尝试用xargs -P实现并行执行，但需控制并发数，避免数据库连接耗尽。
• 安全性：数据库密码尽量通过环境变量传递，不要硬编码在配置文件或脚本中。

内容的提问来源于stack exchange，提问作者Balázs Németh