Manage Your Data

      The Data Service provides access to data. It supports the storing, setting, and retrieving of data-items, specified by key.

      The Data Service is the most fundamental of all Couchbase services, providing read/write access to data in memory and on disk. The Data Service stores data items in Buckets. Before an item can be saved, a bucket must exist for it. Buckets only exist on nodes that run the Data Service.

      Deploying the Data Service

      The Data Service must run on at least one node of every cluster. However, at least three nodes are required for production environments. (Clusters with less than three Data nodes have several limitations.)

      The Data Service provides a fully integrated in-memory caching layer, which provides high-speed data access. Couchbase Capella supports the Couchbase bucket type, which means that all data items are written to memory and persisted to disk. The Data Service manages memory to ensure high performance and scalability: memory quotas are established, and data not recently used can be ejected, to make room for data more frequently requested. You can configure a memory quota that provides caching for all or a portion of stored data items.

      Read more about Memory and Storage.


      Couchbase Capella uses buckets to group collections of keys and values logically. Buckets must be created before you can store any data. A maximum of 30 buckets can be created per cluster.

      Buckets are protected by role-based access control (RBAC). Buckets can only be administered (created, modified, and deleted) by users that have the Project Owner or Project manager project roles.

      Scopes and Collections

      Couchbase Capella uses scopes and collections to categorize and organize documents within a bucket. Collections are data containers within a bucket, while scopes are mechanisms to group multiple collections. Each cluster can have up to 1000 scopes and 1000 collections.

      Every bucket automatically includes the _default scope that itself contains the _default collection. Any document that is created within a bucket that does not reference a scope or collection is saved in the default collection within the default scope. You cannot drop default scopes, and you may only drop default collections using the Couchbase Capella API, SDKs, or queries. You cannot recreate a default collection if you drop it.

      Role-based access control (RBAC) is used to protect scopes and collections. Only project members with the Project Owner or Project manager project roles can administer them.

      For more information, see Scopes and Collections.