{"id":679,"date":"2026-06-01T00:32:47","date_gmt":"2026-05-31T23:32:47","guid":{"rendered":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/?p=679"},"modified":"2026-06-17T00:33:39","modified_gmt":"2026-06-16T23:33:39","slug":"liquibase-datenbank-migrationen-versionieren-mit-yaml-xml-und-json","status":"publish","type":"post","link":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/?p=679","title":{"rendered":"Liquibase \u2014 Datenbank-Migrationen versionieren mit YAML, XML und JSON"},"content":{"rendered":"\n

Datenbank-Migrationen sind ein kritischer Bestandteil moderner Softwareentwicklung. Jede \u00c4nderung am Schema muss nachvollziehbar, reproduzierbar und r\u00fcckg\u00e4ngig machbar sein. W\u00e4hrend Flyway<\/strong> auf nummerierte SQL-Dateien setzt, verfolgt Liquibase<\/strong> einen deklarativen Ansatz: \u00c4nderungen werden in Changeset-Dateien in den Formaten YAML, XML, JSON oder SQL beschrieben.<\/p>\n\n\n\n

Warum Liquibase?<\/h2>\n\n\n\n

Liquibase hat gegen\u00fcber Flyway einige entscheidende Vorteile:<\/p>\n\n\n\n

    \n
  • Datenbankunabh\u00e4ngigkeit<\/strong>\u00a0\u2014 ein Changeset kann (mit Einschr\u00e4nkungen) gegen PostgreSQL, MySQL, Oracle und MSSQL ausgef\u00fchrt werden<\/li>\n\n\n\n
  • Rollback-Unterst\u00fctzung<\/strong>\u00a0\u2014 Liquibase kann \u00c4nderungen automatisch oder manuell zur\u00fccksetzen<\/li>\n\n\n\n
  • Mehrere Formate<\/strong>\u00a0\u2014 YAML, XML, JSON oder SQL als Changeset-Format<\/li>\n\n\n\n
  • Preconditions<\/strong>\u00a0\u2014 Bedingungen, die vor der Ausf\u00fchrung gepr\u00fcft werden<\/li>\n\n\n\n
  • Contexts und Labels<\/strong>\u00a0\u2014 Migrationen lassen sich zielgerichtet auf bestimmte Umgebungen anwenden<\/li>\n<\/ul>\n\n\n\n

    Integration mit Spring Boot 4.1<\/h2>\n\n\n\n

    In Spring Boot 4.1 ist Liquibase per Auto-Configuration integriert. Sobald liquibase-core<\/code> auf dem Classpath liegt, f\u00fchrt Spring Boot beim Start automatisch liquibase update<\/code> aus:<\/p>\n\n\n

    <dependency<\/span>><\/span>\n    <groupId<\/span>><\/span>org.liquibase<\/groupId<\/span>><\/span>\n    <artifactId<\/span>><\/span>liquibase-core<\/artifactId<\/span>><\/span>\n<\/dependency<\/span>><\/span>\n<\/code><\/span>Code-Sprache:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n
    <em<\/span>><\/span># application.yml<\/em<\/span>><\/span>\nspring:\n  liquibase:\n    change-log: classpath:db\/changelog\/db.changelog-master.yaml\n    enabled: true\n<\/code><\/span>Code-Sprache:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
    Die Master-Changelog-Datei referenziert alle einzelnen Changesets:<\/p>\n\n\n
    <em># db.changelog-master.yaml<\/em><\/span>\ndatabaseChangeLog:\n  - include<\/span>:\n      file: db\/changelog\/001<\/span>-create-users.yaml\n  - include<\/span>:\n      file: db\/changelog\/002<\/span>-add-email-column.yaml\n  - include<\/span>:\n      file: db\/changelog\/003<\/span>-create-orders.sql\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
    Changesets in YAML<\/h2>\n\n\n\n
    YAML ist das am einfachsten lesbare Format f\u00fcr Liquibase-Changesets:<\/p>\n\n\n
    <em># 001-create-users.yaml<\/em><\/span>\ndatabaseChangeLog:\n  - changeSet:\n      id: 1<\/span>\n      author: rene\n      changes:\n        - createTable:\n            tableName: users\n            columns:\n              - column:\n                  name: id\n                  type: BIGINT\n                  autoIncrement: true<\/span>\n                  constraints:\n                    primaryKey: true<\/span>\n              - column:\n                  name: username\n                  type: VARCHAR(255<\/span>)\n                  constraints:\n                    nullable: false<\/span>\n                    unique: true<\/span>\n              - column:\n                  name: created_at\n                  type: TIMESTAMP\n                  defaultValueComputed: CURRENT_TIMESTAMP\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
    Rollbacks<\/h2>\n\n\n\n
    Ein Rollback beschreibt, wie eine Migration r\u00fcckg\u00e4ngig gemacht wird:<\/p>\n\n\n
      - changeSet:\n      id: 2\n      author: rene\n      changes:\n        - addColumn:\n            tableName: users\n            columns:\n              - column:\n                  name: email\n                  type: VARCHAR(320)\n      rollback:\n        - dropColumn:\n            tableName: users\n            columnName: email\n<\/code><\/span><\/pre>\n\n\n
    Bei einfachen \u00c4nderungen wie createTable<\/code> generiert Liquibase das Rollback automatisch. Bei komplexeren Operationen muss es explizit definiert werden.<\/p>\n\n\n\n
    SQL-basierte Changesets<\/h2>\n\n\n\n
    Auch purer SQL-Code l\u00e4sst sich verwenden \u2014 mit allen Vorteilen des Liquibase-Trackings:<\/p>\n\n\n
    <em<\/span>><\/span>-- 002-add-index.sql<\/em<\/span>><\/span>\n<em<\/span>><\/span>-- liquibase formatted sql<\/em<\/span>><\/span>\n\n<em<\/span>><\/span>-- changeset rene:3<\/em<\/span>><\/span>\nCREATE INDEX idx_users_email ON users(email);\n\n<em<\/span>><\/span>-- rollback DROP INDEX idx_users_email;<\/em<\/span>><\/span>\n<\/code><\/span>Code-Sprache:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
    Wichtig: Der Kommentar -- liquibase formatted sql<\/code> teilt Liquibase mit, dass die SQL-Datei Changeset-Metadaten enth\u00e4lt.<\/p>\n\n\n\n
    Preconditions<\/h2>\n\n\n\n
    Preconditions verhindern, dass Migrationen unter falschen Voraussetzungen ausgef\u00fchrt werden:<\/p>\n\n\n
      - changeSet:\n      id: 4\n      author: rene\n      preConditions:\n        - onFail: HALT\n        - tableExists:\n            tableName: users\n        - not:\n            columnExists:\n              tableName: users\n              columnName: phone\n      changes:\n        - addColumn:\n            tableName: users\n            columns:\n              - column:\n                  name: phone\n                  type: VARCHAR(20)\n<\/code><\/span><\/pre>\n\n\n
    Mit onFail: HALT<\/code>, MARK_RAN<\/code> oder CONTINUE<\/code> steuert man das Verhalten, falls die Vorbedingung nicht erf\u00fcllt ist.<\/p>\n\n\n\n
    Kontextabh\u00e4ngige Migrationen<\/h2>\n\n\n\n
    Contexts und Labels erlauben migrationsspezifische Ausf\u00fchrungen je nach Umgebung:<\/p>\n\n\n
      - changeSet:\n      id: 5<\/span>\n      author<\/span>: rene\n      context<\/span>: dev\n      labels<\/span>: seed\n      changes<\/span>:\n        - insert:\n            tableName: users\n            columns<\/span>:\n              - column:\n                  name: username\n                  value<\/span>: \"testuser\"<\/span>\n              - column:\n                  name: email\n                  value<\/span>: \"test@example.com\"<\/span>\n<\/code><\/span>Code-Sprache:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n
    <em<\/span>><\/span># Nur Changesets mit dem Kontext \"dev\" ausf\u00fchren<\/em<\/span>><\/span>\nmvn liquibase:update -Dliquibase.contextFilter=dev\n\n<em<\/span>><\/span># Changesets mit Label \"seed\" ausschlie\u00dfen<\/em<\/span>><\/span>\nmvn liquibase:update -Dliquibase.labelFilter=!seed\n<\/code><\/span>Code-Sprache:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
    Fazit<\/h2>\n\n\n\n
    Liquibase ist die ideale Wahl, wenn du datenbankunabh\u00e4ngige, deklarativ beschriebene Migrationen mit vollst\u00e4ndiger Rollback-F\u00e4higkeit ben\u00f6tigst. Die Unterst\u00fctzung f\u00fcr YAML-Changelogs macht Changesets besonders lesbar und diff-bar, w\u00e4hrend Contexts und Preconditions die Steuerung in komplexen Deployment-Pipelines erlauben. In Spring Boot 4.1 ist Liquibase per Autokonfiguration sofort einsatzbereit \u2014 sobald liquibase-core<\/code> auf dem Classpath liegt, werden Migrationen beim Anwendungsstart automatisch ausgef\u00fchrt.<\/p>\n","protected":false},"excerpt":{"rendered":"
    Datenbank-Migrationen sind ein kritischer Bestandteil moderner Softwareentwicklung. Jede \u00c4nderung am Schema muss nachvollziehbar, reproduzierbar und r\u00fcckg\u00e4ngig machbar sein. W\u00e4hrend Flyway auf nummerierte SQL-Dateien setzt, verfolgt Liquibase einen deklarativen Ansatz: \u00c4nderungen werden in Changeset-Dateien in den Formaten YAML, XML, JSON oder SQL beschrieben. Warum Liquibase? Liquibase hat gegen\u00fcber Flyway einige entscheidende Vorteile: Integration mit Spring Boot 4.1 In Spring Boot […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-679","post","type-post","status-publish","format-standard","hentry","category-plain_java"],"_links":{"self":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/679","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=679"}],"version-history":[{"count":1,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/679\/revisions"}],"predecessor-version":[{"id":680,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/679\/revisions\/680"}],"wp:attachment":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=679"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=679"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=679"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}