Liquibase (`liquibase`)

The liquibase endpoint provides information about database change sets applied by Liquibase.spring-doc.cn

Retrieving the Changes

To retrieve the changes, make a GET request to /actuator/liquibase, as shown in the following curl-based example:spring-doc.cn

$ curl 'http://localhost:8080/actuator/liquibase' -i -X GET

The resulting response is similar to the following:spring-doc.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 677

{
  "contexts" : {
    "application" : {
      "liquibaseBeans" : {
        "liquibase" : {
          "changeSets" : [ {
            "author" : "marceloverdijk",
            "changeLog" : "db/changelog/db.changelog-master.yaml",
            "comments" : "",
            "contexts" : [ ],
            "dateExecuted" : "2024-11-21T16:02:50.592Z",
            "deploymentId" : "2204970469",
            "description" : "createTable tableName=customer",
            "execType" : "EXECUTED",
            "id" : "1",
            "labels" : [ ],
            "checksum" : "9:d3589feb2baad02e15540750499ba311",
            "orderExecuted" : 1
          } ]
        }
      }
    }
  }
}

Response Structure

The response contains details of the application’s Liquibase change sets. The following table describes the structure of the response:spring-doc.cn

Path Type Description

Path	Type	Description
`contexts`spring-doc.cn	`Object`spring-doc.cn	Application contexts keyed by idspring-doc.cn
`contexts..liquibaseBeans..changeSets`spring-doc.cn	`Array`spring-doc.cn	Change sets made by the Liquibase beans, keyed by bean name.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].author`spring-doc.cn	`String`spring-doc.cn	Author of the change set.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].changeLog`spring-doc.cn	`String`spring-doc.cn	Change log that contains the change set.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].comments`spring-doc.cn	`String`spring-doc.cn	Comments on the change set.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].contexts`spring-doc.cn	`Array`spring-doc.cn	Contexts of the change set.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].dateExecuted`spring-doc.cn	`String`spring-doc.cn	Timestamp of when the change set was executed.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].deploymentId`spring-doc.cn	`String`spring-doc.cn	ID of the deployment that ran the change set.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].description`spring-doc.cn	`String`spring-doc.cn	Description of the change set.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].execType`spring-doc.cn	`String`spring-doc.cn	Execution type of the change set (`EXECUTED`, `FAILED`, `SKIPPED`, `RERAN`, `MARK_RAN`).spring-doc.cn
`contexts..liquibaseBeans..changeSets[].id`spring-doc.cn	`String`spring-doc.cn	ID of the change set.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].labels`spring-doc.cn	`Array`spring-doc.cn	Labels associated with the change set.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].checksum`spring-doc.cn	`String`spring-doc.cn	Checksum of the change set.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].orderExecuted`spring-doc.cn	`Number`spring-doc.cn	Order of the execution of the change set.spring-doc.cn
`contexts..liquibaseBeans..changeSets[].tag`spring-doc.cn	`String`spring-doc.cn	Tag associated with the change set, if any.spring-doc.cn
`contexts.*.parentId`spring-doc.cn	`String`spring-doc.cn	Id of the parent application context, if any.spring-doc.cn

contextsspring-doc.cn

Objectspring-doc.cn

Application contexts keyed by idspring-doc.cn

contexts.*.liquibaseBeans.*.changeSetsspring-doc.cn

Arrayspring-doc.cn

Change sets made by the Liquibase beans, keyed by bean name.spring-doc.cn

contexts.*.liquibaseBeans.*.changeSets[].authorspring-doc.cn

Stringspring-doc.cn

Author of the change set.spring-doc.cn

contexts.*.liquibaseBeans.*.changeSets[].changeLogspring-doc.cn

Stringspring-doc.cn

Change log that contains the change set.spring-doc.cn