Advanced Analytica Advanced Analytica: IBOM
← All connectors
Couchbase logo

Source connector

Couchbase

Set up Couchbase as a source and move its data into your chosen destination.

Version 0.1.10 community alpha

Couchbase

Set up the Couchbase source connector and find its reference information on this page.

Prerequisites

  • Couchbase server version 7.0 or later, or a Couchbase Capella account
  • Couchbase connection string
  • Couchbase username and password

Setup guide

Step 1: Set up Couchbase

Option A: Couchbase Capella (Cloud)

  1. Create a Couchbase Capella account:

  2. Create a Capella cluster:

    • Sign in to your Capella account.
    • Select “Create Cluster” in the dashboard.
    • Choose your cloud provider (AWS, Azure, or GCP) and your preferred deployment region.
    • Select the cluster size and configuration that meet your needs.
    • Select “Create Cluster” and wait for deployment to finish. This may take a few minutes.
  3. Set up database access:

    • In the Capella UI, go to “Security” > “Database Access”.
    • Select “Add User” to create a database user.
    • Enter a username and password for the new user.
    • Assign the appropriate roles for the buckets you want to replicate, such as “Data Reader” and “Data Writer”.
    • Select “Save” to create the user.
  4. Configure allowed IP ranges:

    • In the Capella UI, go to “Security” > “Allowed IP Addresses”.
    • Select “Add Allowed IP”.
    • Enter the IP address or CIDR range your Airbyte instance will connect from.
    • Add a description for the IP range, such as “Airbyte Connection”.
    • Select “Add” to save the allowed IP range.
  5. Get your cluster credentials:

    • In the Capella UI, open your cluster’s “Connect” tab.
    • Find the connection string, which typically looks like: couchbases://cb.<your-cluster-id>.cloud.couchbase.com
    • Save this connection string. You’ll need it to configure the Airbyte connector.

Option B: Self-hosted Couchbase

  1. Make sure your Couchbase server, version 7.0 or later, is running.
  2. Create a user with the permissions needed to access the data you want to replicate.

Step 2: Set up the Couchbase connector in Airbyte

  1. In the Airbyte UI, open the Sources page and select Couchbase from the available sources.
  2. Enter a name for your source.
  3. Enter the Couchbase connection string:
    • For Capella: Use the connection string from the “Connect” tab, such as couchbases://cb.<your-cluster-id>.cloud.couchbase.com.
    • For self-hosted: Use your server’s connection string, such as couchbase://localhost.
  4. Enter your Couchbase username and password. For Capella, use the credentials you created in Step 1.3.
  5. Enter the name of the bucket you want to replicate.
  6. Optional: Enter a JSON object containing additional properties to pass to the Couchbase client.

Supported sync modes

You can use the following sync modes with the Couchbase source connector:

FeatureSupported?
Full Refresh SyncYes
Incremental - Append SyncYes
Replicate Incremental DeletesNo
CDCNo

Supported streams

The Couchbase source connector replicates every collection in the specified bucket as an individual stream. It skips collections in the Couchbase-managed _system scope.

Each collection needs a primary index for SQL++ queries. During discovery, the connector attempts to create one (CREATE PRIMARY INDEX IF NOT EXISTS ...).

If the configured user can’t manage indexes, create the primary index before syncing. Otherwise, the sync fails with a “No primary index is available” error.

Performance considerations

Couchbase server or Couchbase Capella cluster capacity limits the connector’s rate. Adjust the batch size and worker count for your server capacity and network conditions.

For Capella, consider your cluster’s performance limits and pricing tier. You may need to upgrade when replicating large data volumes or requiring higher throughput.

IP allow list

If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

VersionDatePull RequestSubject
0.1.102026-10-0788341Fix image build (0.1.9 was never published); page documents by META().id instead of sorting whole collections in one query (fixes query timeouts / out-of-memory on large collections); clear config error when the primary index is missing; skip the _system scope
0.1.92026-06-0278669Update dependencies
0.1.82025-05-2460362Update dependencies
0.1.72025-05-1059945Update dependencies
0.1.62025-05-0359406Update dependencies
0.1.52025-04-2658855Update dependencies
0.1.42025-04-1957810Update dependencies
0.1.32025-04-0556552Update dependencies
0.1.22025-03-2255965Update dependencies
0.1.12025-03-0855324Update dependencies
0.1.02023-10-12#45876Initial release of Couchbase Source Connector
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.