Liquibaseとは？DBスキーマ変更の版管理と適用

ページ内ナビ

概要

Liquibaseは、テーブルや列などのデータベース変更をchangelogに記述し、環境ごとの適用状況を追跡する変更管理ツールです。変更を順序付けて適用し、必要に応じてロールバックできるため、アプリケーションのリリース工程へデータベース更新を組み込めます。CLIのほかMaven、Gradle、Spring Boot、CI/CDツールと連携できます。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日：2026-10-04

主な特徴

スキーマ変更を履歴として管理し、未適用分だけを実行する

XML、YAML、JSON、SQLなどで変更内容をchangelogへ記録し、Liquibaseがデータベース側の履歴と照合します。環境ごとに未適用のchangesetを識別して順序どおりに実行でき、差分生成やロールバックも変更管理の流れへ組み込めます。

出典：[1]

向いている用途

複数環境のデータベース変更をリリース工程へ組み込みたいチームに向く

開発・検証・本番で同じ変更履歴をレビューし、アプリケーション配備と合わせて自動実行したい場合に向きます。複数のデータベース製品を扱う組織や、Maven、Gradle、Spring Boot、GitHub Actionsなど既存の開発工程へ変更管理を加えたいチームでも候補になります。

出典：[1]

導入前の確認

5系のライセンスとドライバー構成を導入前に確認する

Liquibase Community 5はFSL-1.1-ALv2で提供され、競合用途を制限し、公開から2年後にApache-2.0へ移行する条件です。GitHubのSPDX判定もNOASSERTIONのため、組織の利用形態をLICENSE本文と照合してください。

5系のCommunity配布物とコンテナにはデータベースドライバーや拡張が既定で含まれません。接続先に応じてLPMなどで追加し、認証情報をchangelogやログへ残さない運用が必要です。v5.0.4は認証情報のマスキングや、コード実行につながるchangelog機能を制限する設定も追加しています。

出典：[3][2][4]

参考にした公式資料

[1]Liquibase v5.0.4 README(2026-10-04)
[2]Liquibase v5.0.4 Docker README(2026-10-04)
[3]Liquibase v5.0.4 FSL license(2026-10-04)
[4]Liquibase v5.0.4 release(2026-10-04)

編集部からの補足

アプリケーションの配備とデータベース変更を同じ変更履歴で追跡できる点が比較の軸です。5系ではCommunity版のライセンスとドライバー同梱方針が変わったため、4系からの移行では運用手順だけでなく利用条件と配布物も確認してください。

3ステップで試す

1
固定版のCommunityイメージを取得する
Liquibase Community 5.0.4を固定して取得します。5系のCommunityイメージにはデータベースドライバーが既定で含まれません。
docker pull liquibase/liquibase:5.0.4
2
ローカル検証用changelogを作る
本番データベースへ接続せず、空の変更履歴をローカルに用意します。
mkdir -p liquibase-demo && printf '%s ' '<?xml version="1.0" encoding="UTF-8"?>' '<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog https://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd"></databaseChangeLog>' > liquibase-demo/changelog.xml
3
オフライン接続で構文を検証する
/liquibase/changelogへマウントするとコンテナの作業ディレクトリもそこへ切り替わるため、相対パスのchangelog.xmlをoffline URLで検証できます。実際の接続先へ適用する前に、対象DBのドライバーと認証情報を別途安全に設定してください。
docker run --rm -v "$PWD/liquibase-demo:/liquibase/changelog" liquibase/liquibase:5.0.4 --url=offline:postgresql --changelog-file=changelog.xml validate

公式READMEで確認

成長

成長の推移 · 直近30日

5,618 Stars

推移データを蓄積中です。

開発アクティビティ

直近90日・週次

Commit（直近30日）: 35
Open PR: 76

開発アクティビティを蓄積中です。

Built with

カテゴリとタグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る

GitHubで見る

GitHub Topics

java
liquibase
database-migrations
java-library
continuous-delivery
devops
sql
continuous-deployment
database
database-management
database-administration
mysql

Stars: 5,618
Forks: 1,973
Watchers: 136
Open Issues: 188
Contributors: 314
所有者種別: Organization
主要言語: Java
ライセンス: 未判定
リポジトリ最終更新: 2026/10/04