How-To: Update the XSD Version

Applies to

• Liquibase Secure (Pro)
• Liquibase Community (Open Source)

Environment Conditions

• Any version of Liquibase Secure (Pro) or Community

Summary

When using Liquibase, it’s crucial to ensure that your XML changelog files use the correct XSD version to match your Liquibase version. An outdated or incorrect XSD version can lead to validation errors or the inability to use certain commands or attributes.

How-To: Update the XSD Version

1. Open your Liquibase changelog file (.xml).
2. Locate the XML declaration line at the top, referencing the XSD version.
3. Update the URL to the correct XSD version for your Liquibase version.
   • Liquibase Secure examples (version 5.0+):

     • xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext"
       xmlns:secure="http://www.liquibase.org/xml/ns/secure"
       xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
         http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-<version>.xsd
         http://www.liquibase.org/xml/ns/dbchangelog-ext
         http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd
         http://www.liquibase.org/xml/ns/secure
         http://www.liquibase.org/xml/ns/secure/liquibase-secure-<version>.xsd"

   • Liquibase Pro example (prior to version 5.0):

     • xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:pro="http://www.liquibase.org/xml/ns/pro"
       xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
         http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-<version>.xsd
         http://www.liquibase.org/xml/ns/pro
         http://www.liquibase.org/xml/ns/pro/liquibase-pro-<version>.xsd"

   • <version> is the version of the XSD that is being used. For example: http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.29.xsd
4. Save the file.
5. Run Liquibase to ensure no validation errors occur.

Note: Please check dbchangelog for all of the available XSD versions.