Secure 5.1.1: Couchbase executeQueryFile

Couchbase executeQueryFile

Last updated: July 13, 2026

Executes SQL++ queries from an external file against the Couchbase cluster.

Known limitations:

There is no automatic rollback support. Queries that modify data are permanent.
The SQL++ file must be accessible at the specified path when the migration runs.
Multiple statements in the file are executed sequentially.

Available attributes

You must specify all top-level attributes marked as required. If you specify an optional attribute, you must also specify any nested attributes that it requires.

Attribute	Type	Description	Required
`transactional`	Boolean	When `true`, executes the file's queries within a transaction. Specified as an XML attribute on the element itself.	No
`file`	Element	The file reference. See nested tags below.	Yes

Nested tags — file

Attribute	Type	Description	Required
`filePath`	String	Path to the SQL++ file containing the queries to execute.	Yes
`relative`	Boolean	When `true`, the path is resolved relative to the changelog file. Default: `false`.	No

<?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"
        xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.19.xsd
        http://www.liquibase.org/xml/ns/dbchangelog-ext http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-couchbase-ext.xsd">

    <changeSet id="1" author="liquibase">
        <ext:executeQueryFile transactional="false">
            <ext:file>
                <ext:filePath>src/main/resources/queries/my-queries.sql</ext:filePath>
            </ext:file>
        </ext:executeQueryFile>
    </changeSet>

</databaseChangeLog>

{
  "databaseChangeLog": [
    {
      "changeSet": {
        "id": "1",
        "author": "liquibase",
        "executeQueryFile": {
          "transactional": false,
          "file": {
            "filePath": "src/main/resources/queries/my-queries.sql"
          }
        }
      }
    }
  ]
}

databaseChangeLog:
  - changeSet:
      id: '1'
      author: liquibase
      executeQueryFile:
        transactional: false
        file:
          filePath: src/main/resources/queries/my-queries.sql

<?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"
        xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.19.xsd
        http://www.liquibase.org/xml/ns/dbchangelog-ext http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-couchbase-ext.xsd">

    <changeSet id="1" author="liquibase">
        <ext:executeQueryFile transactional="false">
            <ext:file>
                <ext:filePath>src/main/resources/queries/my-queries.sql</ext:filePath>
            </ext:file>
        </ext:executeQueryFile>
    </changeSet>

</databaseChangeLog>

{
  "databaseChangeLog": [
    {
      "changeSet": {
        "id": "1",
        "author": "liquibase",
        "executeQueryFile": {
          "transactional": false,
          "file": {
            "filePath": "src/main/resources/queries/my-queries.sql"
          }
        }
      }
    }
  ]
}

databaseChangeLog:
  - changeSet:
      id: '1'
      author: liquibase
      executeQueryFile:
        transactional: false
        file:
          filePath: src/main/resources/queries/my-queries.sql

Couchbase executeQueryFile

Available attributes

Nested tags — file

XML example

JSON example

YAML example

More like this