Advanced Analytica Advanced Analytica: IBOM
← All connectors
Couchbase logo

Destination connector

Couchbase

Send governed data into Couchbase with a clear, practical setup guide.

Version 0.1.9 community alpha

Couchbase

Use this guide to set up the Couchbase destination connector and find reference information.

Overview

You can sync data to Couchbase, a distributed NoSQL database. The connector writes each stream to a collection. It supports local clusters and Couchbase Capella, the cloud service.

Output schema

The connector writes each stream to a Couchbase collection and maps data using these rules:

  • The connector stores each record as a JSON document in Couchbase
  • The stream name becomes the collection name, sanitised to meet Couchbase naming rules
  • Each document contains:
    • id: A unique identifier, using a UUID or composite key for deduplication
    • type: Set to “airbyte_record”
    • stream: The source stream name
    • data: The record data

Performance

  • The connector uses batch operations to improve performance
  • The connector automatically creates primary indexes for each collection
  • For large datasets, consider using incremental sync modes
  • Adjust the batch size if needed. The default is 1000 documents

Supported sync modes

Sync modeSupported?
Full Refresh - OverwriteYes
Full Refresh - AppendYes
Full Refresh - Overwrite + DedupedYes
Incremental Sync - AppendYes
Incremental Sync - Append + DedupedYes

Get started

Requirements

Local cluster requirements

  1. Couchbase Server 7.0 or later installed
  2. A bucket created in Couchbase
  3. A username and password with these permissions:
    • Data Reader (data_reader)
    • Data Writer (data_writer)
    • Query Manager (query_manage_index)

Capella cloud requirements

  1. A Couchbase Capella account
  2. Database access credentials:
    • Database username
    • Database password
  3. A bucket created in your Capella cluster
  4. Allow-list the IP addresses that Airbyte will connect from

Setup guide

Set up a local cluster

  1. Install Couchbase Server

  2. Create Resources

    • In the Couchbase Web Console, go to “Buckets” and click “Add Bucket”
    • Enter these bucket details:
      • Name: mybucket
      • Memory Quota: Set an appropriate size (e.g. 100 MB)
      • Bucket Type: Couchbase
      • Click “Add Bucket” to create it
  3. Configure in Airbyte

    • Connection String: Enter your Couchbase connection string (e.g. couchbase://localhost)
    • Username: Enter your database username (e.g. airbyte_user)
    • Password: Enter your database password (e.g. your_secure_password)
    • Bucket: Enter your bucket name (e.g. my_bucket)
    • Scope: Enter your scope name (defaults to _default)

Set up Capella

  1. Create Capella Resources

    • Log in to Couchbase Capella
    • Create a new database or use an existing one
    • Create a bucket for your data
  2. Create Database Credentials

    • In Capella, go to “Security → Database Access”
    • Click “Create Database Credential”
    • Save the username and password
  3. Allow List IP Addresses

  4. Get Connection Details

    • In Capella, go to “Connect”
    • Copy the connection string
  5. Configure in Airbyte

    • Connection String: Your Capella connection string
    • Username: Database username
    • Password: Database password
    • Bucket: Your bucket name
    • Scope: _default (or your custom scope)

Connection configuration

ParameterDescriptionExample
Connection StringThe connection string to your Couchbase clustercouchbase://localhost or Capella connection string
UsernameDatabase username with required permissionsairbyte
PasswordDatabase passwordpassword
BucketThe name of the bucket to sync data tomybucket
ScopeThe scope within the bucket (optional, defaults to _default)_default

Namespace support

This destination supports namespaces.

Changelog

VersionDatePull RequestSubject
0.1.92025-05-2460719Update dependencies
0.1.82025-05-1059875Update dependencies
0.1.72025-05-0359358Update dependencies
0.1.62025-04-2658279Update dependencies
0.1.52025-04-1257651Update dependencies
0.1.42025-04-0557148Update dependencies
0.1.32025-03-2956612Update dependencies
0.1.22025-03-2256082Update dependencies
0.1.12025-03-0855354Update dependencies
0.1.02024-01-20#xxxxxInitial release of the Couchbase destination 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.