Java for Beginner

Типы changesets и стратегии развертывания в Liquibase

1. Основные изменения (changesets)

1.1. Создание таблиц (createTable)
Позволяет создавать новые таблицы с указанием столбцов и ограничений.

Пример (YAML):

databaseChangeLog:  
  - changeSet:  
      id: 1  
      author: dev  
      changes:  
        - createTable:  
            tableName: users  
            columns:  
              - column:  
                  name: id  
                  type: BIGINT  
                  autoIncrement: true  
                  constraints:  
                    primaryKey: true  
                    nullable: false  
              - column:  
                  name: username  
                  type: VARCHAR(50)  
                  constraints:  
                    unique: true

Разбор:
tableName – имя таблицы.
columns – список столбцов.
constraints – ограничения (primaryKey, nullable, unique).

1.2. Добавление столбцов (addColumn)
Добавляет новый столбец в существующую таблицу.

Пример (YAML):

- changeSet:  
    id: 2  
    author: dev  
    changes:  
      - addColumn:  
          tableName: users  
          columns:  
            - column:  
                name: email  
                type: VARCHAR(100)  
                constraints:  
                  nullable: false

Параметры:
tableName – имя таблицы.
defaultValue – значение по умолчанию (опционально).

1.3. Изменение структуры (alterTable, modifyDataType)
Используется для изменения типа данных столбца или переименования таблицы.

Пример (YAML):

- changeSet:  
    id: 3  
    author: dev  
    changes:  
      - alterTable:  
          tableName: users  
          columns:  
            - column:  
                name: username  
                type: VARCHAR(100)  # Увеличение длины  
      - renameColumn:  
          tableName: users  
          oldColumnName: email  
          newColumnName: email_address

2. Управление зависимостями

2.1. Атрибуты runAlways и runOnChange
runAlways="true" – changeSet выполняется каждый раз, даже если уже был применен.

- changeSet:  
    id: 4  
    author: dev  
    runAlways: true  
    changes:  
      - sql:  
          sql: "INSERT INTO logs (message) VALUES ('Migration executed')"  
runOnChange="true" – выполняется только если содержимое changeSet’а изменилось.

2.2. Условия (preConditions)
Проверяют условия перед выполнением changeSet’а.

Пример (YAML):

- changeSet:  
    id: 5  
    author: dev  
    preConditions:  
      - tableExists:  
          tableName: users  
    changes:  
      - addColumn:  
          tableName: users  
          columns:  
            - column:  
                name: status  
                type: VARCHAR(20)

Доступные проверки:
tableExists / tableNotExists
columnExists
sqlCheck (произвольный SQL-запрос).

3. Стратегии развертывания

3.1. Последовательное применение
ChangeSet’ы выполняются строго по порядку, указанному в databaseChangeLog.

Пример:

databaseChangeLog:  
  - include:  
      file: db/changelog/v1.0/001-create-tables.yaml  
  - include:  
      file: db/changelog/v1.0/002-add-constraints.yaml

3.2. Параллельное выполнение
Liquibase не поддерживает параллельное выполнение changeSet’ов по умолчанию.

Однако можно:
Разделять changelog на независимые модули.
Использовать contexts для условного выполнения.

Пример:

- changeSet:  
    id: 6  
    author: dev  
    context: "!prod"  # Не выполнять в production  
    changes:  
      - insert:  
          tableName: test_data  
          columns:  
            - column:  
                name: value  
                value: "Test"

4. Поддержка разных форматов

Liquibase позволяет использовать:
YAML – лаконичный и удобный для разработчиков.
XML – строгий и структурированный.
JSON – альтернатива YAML.
SQL – для прямого написания SQL-запросов.

Пример SQL-формата:

--liquibase formatted sql  

--changeset dev:7  
CREATE INDEX idx_user_email ON users(email);  

--changeset dev:8 context:prod  
ALTER TABLE users ADD COLUMN last_login TIMESTAMP;

#Java #middle #Liquibase

110 views05:59