Secure 5.1.1: Couchbase removeDocuments

Couchbase removeDocuments

Last updated: July 13, 2026

Removes one or more documents from a Couchbase collection by document key, N1QL WHERE clause, or SQL++ query.

Known limitations:

This operation is irreversible. There is no automatic rollback support.
Using whereCondition or sqlPlusPlusQuery will remove all documents matching the condition.

Available attributes

Attribute	Type	Description	Required
`bucketName`	String	The name of the bucket containing the collection.	Yes
`scopeName`	String	The name of the scope containing the collection.	Yes
`collectionName`	String	The name of the collection to remove documents from.	Yes
`id`	String	The key of a document to remove. Multiple `id` elements can be specified. Mutually exclusive with `whereCondition` and `sqlPlusPlusQuery`.	Yes*
`whereCondition`	String	An N1QL WHERE clause identifying documents to remove. Mutually exclusive with `id` and `sqlPlusPlusQuery`.	Yes*
`sqlPlusPlusQuery`	String	A full SQL++ query for document selection. Mutually exclusive with `id` and `whereCondition`.	Yes*

<?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:removeDocuments>
            <ext:bucketName>myBucket</ext:bucketName>
            <ext:scopeName>myScope</ext:scopeName>
            <ext:collectionName>myCollection</ext:collectionName>
            <ext:whereCondition>field1="val1"</ext:whereCondition>
        </ext:removeDocuments>
    </changeSet>

</databaseChangeLog>

{
  "databaseChangeLog": [
    {
      "changeSet": {
        "id": "1",
        "author": "liquibase",
        "removeDocuments": {
          "bucketName": "myBucket",
          "scopeName": "myScope",
          "collectionName": "myCollection",
          "whereCondition": "field1=\"val1\""
        }
      }
    }
  ]
}

databaseChangeLog:
  - changeSet:
      id: '1'
      author: liquibase
      removeDocuments:
        bucketName: myBucket
        scopeName: myScope
        collectionName: myCollection
        whereCondition: 'field1="val1"'

<?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:removeDocuments>
            <ext:bucketName>myBucket</ext:bucketName>
            <ext:scopeName>myScope</ext:scopeName>
            <ext:collectionName>myCollection</ext:collectionName>
            <ext:whereCondition>field1="val1"</ext:whereCondition>
        </ext:removeDocuments>
    </changeSet>

</databaseChangeLog>

{
  "databaseChangeLog": [
    {
      "changeSet": {
        "id": "1",
        "author": "liquibase",
        "removeDocuments": {
          "bucketName": "myBucket",
          "scopeName": "myScope",
          "collectionName": "myCollection",
          "whereCondition": "field1=\"val1\""
        }
      }
    }
  ]
}

databaseChangeLog:
  - changeSet:
      id: '1'
      author: liquibase
      removeDocuments:
        bucketName: myBucket
        scopeName: myScope
        collectionName: myCollection
        whereCondition: 'field1="val1"'

Couchbase removeDocuments

Available attributes

XML example

JSON example

YAML example

More like this