Oracle APEX集成sqlcl liquibase：多环境差异化数据迁移方案求助

针对你提到的ENVRONMENT_VARIABLES表在不同环境（DEV/UAT/PRD）的差异化数据自动化迁移需求，分享几个基于Oracle官方SQLcl Liquibase原生特性的实践方案，完全替代手动执行脚本：

方案一：上下文（Contexts）+ 属性文件（推荐） #

利用Liquibase的上下文区分环境，结合属性文件存储各环境专属值，实现一次编写、多环境适配：

1. 创建环境属性文件
   为每个环境单独创建属性文件，比如：

   # dev.properties
   env.label=DEV
   image.server=http://dev_server:8080
   

   # uat.properties
   env.label=UAT
   image.server=http://uat_server:8085
   

   # prd.properties
   env.label=PRD
   image.server=http://prd_server:8085
   

2. 编写Liquibase Changelog
   使用<merge>标签实现数据的upsert（避免重复插入/更新），结合上下文控制环境专属逻辑：

   <changeSet id="sync_env_variables" author="your-team">
       <preConditions onFail="MARK_RAN">
           <tableExists tableName="ENVRONMENT_VARIABLES"/>
       </preConditions>
       
       <!-- 所有环境通用数据 -->
       <merge tableName="ENVRONMENT_VARIABLES">
           <column name="variable_key" value="process_start_date"/>
           <column name="variable_value" value="01/01/2023"/>
       </merge>
       
       <!-- DEV环境专属数据 -->
       <merge tableName="ENVRONMENT_VARIABLES" context="dev">
           <column name="variable_key" value="env_label"/>
           <column name="variable_value" value="${env.label}"/>
       </merge>
       <merge tableName="ENVRONMENT_VARIABLES" context="dev">
           <column name="variable_key" value="image_server"/>
           <column name="variable_value" value="${image.server}"/>
       </merge>
       
       <!-- UAT环境专属数据 -->
       <merge tableName="ENVRONMENT_VARIABLES" context="uat">
           <column name="variable_key" value="env_label"/>
           <column name="variable_value" value="${env.label}"/>
       </merge>
       <merge tableName="ENVRONMENT_VARIABLES" context="uat">
           <column name="variable_key" value="image_server"/>
           <column name="variable_value" value="${image.server}"/>
       </merge>
       
       <!-- PRD环境专属数据 -->
       <merge tableName="ENVRONMENT_VARIABLES" context="prd">
           <column name="variable_key" value="env_label"/>
           <column name="variable_value" value="${env.label}"/>
       </merge>
       <merge tableName="ENVRONMENT_VARIABLES" context="prd">
           <column name="variable_key" value="image_server"/>
           <column name="variable_value" value="${image.server}"/>
       </merge>
   </changeSet>
   

3. 部署命令
   执行Liquibase更新时指定对应环境的上下文和属性文件：

   # DEV环境部署
   liquibase --contexts=dev --defaultsFile=dev.properties update
   
   # UAT环境部署
   liquibase --contexts=uat --defaultsFile=uat.properties update
   
   # PRD环境部署
   liquibase --contexts=prd --defaultsFile=prd.properties update
   

方案二：变更集标签（Labels）+ 环境专属变更集 #

如果环境数据相对固定，可通过标签区分通用和环境专属变更集，部署时按需执行：

<!-- 通用数据变更集 -->
<changeSet id="env_vars_common" author="your-team" labels="common">
    <merge tableName="ENVRONMENT_VARIABLES">
        <column name="variable_key" value="process_start_date"/>
        <column name="variable_value" value="01/01/2023"/>
    </merge>
</changeSet>

<!-- DEV专属变更集 -->
<changeSet id="env_vars_dev" author="your-team" labels="dev">
    <merge tableName="ENVRONMENT_VARIABLES">
        <column name="variable_key" value="env_label"/>
        <column name="variable_value" value="DEV"/>
    </merge>
    <merge tableName="ENVRONMENT_VARIABLES">
        <column name="variable_key" value="image_server"/>
        <column name="variable_value" value="http://dev_server:8080"/>
    </merge>
</changeSet>

<!-- UAT专属变更集 -->
<changeSet id="env_vars_uat" author="your-team" labels="uat">
    <merge tableName="ENVRONMENT_VARIABLES">
        <column name="variable_key" value="env_label"/>
        <column name="variable_value" value="UAT"/>
    </merge>
    <merge tableName="ENVRONMENT_VARIABLES">
        <column name="variable_key" value="image_server"/>
        <column name="variable_value" value="http://uat_server:8085"/>
    </merge>
</changeSet>

<!-- PRD专属变更集 -->
<changeSet id="env_vars_prd" author="your-team" labels="prd">
    <merge tableName="ENVRONMENT_VARIABLES">
        <column name="variable_key" value="env_label"/>
        <column name="variable_value" value="PRD"/>
    </merge>
    <merge tableName="ENVRONMENT_VARIABLES">
        <column name="variable_key" value="image_server"/>
        <column name="variable_value" value="http://prd_server:8085"/>
    </merge>
</changeSet>

部署命令：

# DEV环境：执行通用+DEV标签的变更集
liquibase --labels=common,dev update

# UAT环境：执行通用+UAT标签的变更集
liquibase --labels=common,uat update

# PRD环境：执行通用+PRD标签的变更集
liquibase --labels=common,prd update

方案三：SQLcl变量注入 + Liquibase SQL标签 #

如果你的CI/CD流水线已注入环境变量，可直接在SQL中引用这些变量，无需额外维护属性文件：

<changeSet id="sync_env_variables" author="your-team">
    <preConditions onFail="MARK_RAN">
        <tableExists tableName="ENVRONMENT_VARIABLES"/>
    </preConditions>
    <sql>
        MERGE INTO ENVRONMENT_VARIABLES t
        USING (
            SELECT 'process_start_date' AS variable_key, '01/01/2023' AS variable_value FROM DUAL
            UNION ALL
            SELECT 'env_label' AS variable_key, '&ENV_LABEL.' AS variable_value FROM DUAL
            UNION ALL
            SELECT 'image_server' AS variable_key, '&IMAGE_SERVER.' AS variable_value FROM DUAL
        ) s
        ON (t.variable_key = s.variable_key)
        WHEN MATCHED THEN UPDATE SET t.variable_value = s.variable_value
        WHEN NOT MATCHED THEN INSERT (variable_key, variable_value) VALUES (s.variable_key, s.variable_value);
    </sql>
</changeSet>

部署命令（通过SQLcl传递变量）：

# DEV环境
sqlcl username/password@dev_db @liquibase-update.sql ENV_LABEL=DEV IMAGE_SERVER=http://dev_server:8080

# UAT环境
sqlcl username/password@uat_db @liquibase-update.sql ENV_LABEL=UAT IMAGE_SERVER=http://uat_server:8085

# PRD环境
sqlcl username/password@prd_db @liquibase-update.sql ENV_LABEL=PRD IMAGE_SERVER=http://prd_server:8085

方案选型建议 #

• 方案一：适合环境变量需频繁修改、新增变量只需更新属性文件的场景，维护成本最低。
• 方案二：适合环境数据固定、不常变动的场景，逻辑直观，易于排查问题。
• 方案三：适合已有成熟CI/CD流水线、可直接复用流水线环境变量的场景，无需额外配置文件。

内容的提问来源于stack exchange，提问作者McRivers