使用Liquibase添加列检查约束的方案与最佳实践咨询

关于checkConstraint属性的说明 #

你推测的没错，Liquibase Community（社区版）并不支持<constraints>标签中的checkConstraint属性，该特性仅属于Liquibase Pro版本，这也是你使用后无效的原因。

可行方案 #

1. 使用<addCheckConstraint>变更类型（社区版支持，推荐）

这是Liquibase官方提供的跨数据库兼容方案，社区版完全支持，无需手写原生SQL。

示例1：创建表后添加检查约束

<changeSet id="add-age-check-constraint" author="your-name">
    <addCheckConstraint 
        tableName="person_jn" 
        columnNames="age" 
        constraintName="check_age"
        checkExpression="age >= 0 AND age <= 1000"/>
</changeSet>

示例2：创建表时同步添加（需通过独立的<addCheckConstraint>，而非内嵌到<column>）

<changeSet id="create-person-table-with-check" author="your-name">
    <createTable tableName="person_jn">
        <column name="id" type="INT" autoIncrement="true">
            <constraints primaryKey="true"/>
        </column>
        <column name="age" type="INT"/>
    </createTable>
    <!-- 单独添加检查约束 -->
    <addCheckConstraint 
        tableName="person_jn" 
        columnNames="age" 
        constraintName="check_age"
        checkExpression="age >= 0 AND age <= 1000"/>
</changeSet>

2. 使用<sql>标签（适配多数据库）

如果必须使用原生SQL，可通过dbms属性为不同数据库编写适配的SQL语句，避免兼容性问题。

示例：分数据库适配CHECK约束

<changeSet id="add-age-check-via-sql" author="your-name">
    <!-- MySQL 8.0+ 支持CHECK约束生效 -->
    <sql dbms="mysql">
        ALTER TABLE person_jn ADD CONSTRAINT check_age CHECK (age >= 0 AND age <= 1000);
    </sql>
    <!-- Oracle 语法 -->
    <sql dbms="oracle">
        ALTER TABLE person_jn ADD CONSTRAINT check_age CHECK (age >= 0 AND age <= 1000);
    </sql>
    <!-- PostgreSQL 语法 -->
    <sql dbms="postgresql">
        ALTER TABLE person_jn ADD CONSTRAINT check_age CHECK (age >= 0 AND age <= 1000);
    </sql>
    <!-- 旧版MySQL（<8.0）需用触发器模拟CHECK效果 -->
    <sql dbms="mysql,mysql5">
        CREATE TRIGGER trg_person_age_check BEFORE INSERT ON person_jn
        FOR EACH ROW
        BEGIN
            IF NEW.age < 0 OR NEW.age > 1000 THEN
                SIGNAL SQLSTATE '45000' SET MESSAGE_TEXT = 'Age must be between 0 and 1000';
            END IF;
        END;
    </sql>
</changeSet>

最佳实践 #

• 优先使用<addCheckConstraint>：该变更类型会自动适配不同数据库的语法，最大程度保证跨库兼容性，减少维护成本。
• 为约束命名：明确的约束名（如check_age）便于后续查看、修改或删除约束，避免数据库自动生成的随机名称。
• 注意数据库特性差异：部分数据库对CHECK约束的支持有特殊情况，比如MySQL 8.0之前的版本仅解析但不强制执行CHECK约束，需用触发器替代；SQL Server的CHECK约束默认启用。
• 测试兼容性：在目标数据库环境中执行变更集，验证约束是否正常生效。

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