Qubit Docs العربية

Couchbase

Connect a Couchbase cluster, including Couchbase Capella, so Qubit can copy the collections in one scope on a schedule. Each collection becomes a table.

Before you start

  • Create a database user for Qubit with read access to the bucket.
  • Make sure each collection you want to sync has a primary index. Qubit cannot read a collection without one.
  • Make sure the cluster accepts connections from Qubit's servers.

Connect Couchbase

  1. Open Data Catalog from the sidebar, click Add Data, then choose Connect a database.
  2. On the New Data Source page, click Couchbase. It is under Databases.
  3. Enter a Connection Name.
  4. Fill in the connection details:
    • Connection String: for example couchbases://cb.example.cloud.couchbase.com.
    • Username and Password: the database user you created.
    • Bucket: the bucket to read.
    • Scope: the scope inside the bucket. Defaults to _default. Every collection in the scope becomes a table.
  5. Choose a Sync Schedule. The default is Daily.
  6. Click Create.

After you connect

Qubit checks that the required fields are filled in, saves the connection, and starts the first sync. It confirms that it can reach the cluster during that sync.

To check the connection at any time, open its menu in the Data Catalog and choose Test connection. If Last sync shows Failed, hover over it to see the reason, correct the details with Edit, then choose Sync now. A wrong username or password shows up as an authentication error.