Configure Your Database

      Databases are managed deployments of Couchbase Server.

      This page walks you through an overview of databases in Couchbase Capella. A database is a managed deployment of Couchbase Server. A database comprises one or more instances of Couchbase Server, each running on an independent node.

      In the Capella hierarchy, projects are contained in organizations. Databases are contained in projects. Databases are fully managed and deployed in Couchbase’s VPC for a chosen cloud provider.


      A database comprises of one or more services. Couchbase services enable you to access and maintain your data.

      The following services are available:

      Service Description Further Information

      Data Service

      Supports the storing, setting, and retrieving of data items specified by key.

      All databases must run the Data Service. The Data Service must run on at least one node of every database. However, at least three nodes are required for production environments. Databases with fewer than three Data nodes have several limitations.

      Manage Your Data

      Query Service

      Parses queries specified in the SQL++ query language, executes the queries, and returns results. The Query Service interacts with the Data and Index Services.

      Query Data with SQL++

      Index Service

      Creates indexes used by the Query Service.

      Primary and Secondary Index Reference

      Search Service

      Create indexes especially purposed for Full Text Search. This service supports language-aware searching. For example, it can allow users to search for beauties and obtain results for beauty and beautiful.

      Add Search to Your Application

      Eventing Service

      Supports near real-time handling of data changes. Code can be executed in response to document mutations and as scheduled by timers.


      Analytics Service

      Supports join, set, aggregation, and grouping operations, which are expected to be large, long-running, and highly consumptive of memory and CPU resources.

      Analyze Large Datasets

      Deploying Services

      Each instance of a service runs on its own service group. A service group includes the Couchbase services that are deployed on a database node, and the system resources, such as compute and storage, of the cloud VM that the node is deployed with. Each service group also has a node quantity. Node quantity represents the number of nodes in the database with the same configuration.

      Each service can be deployed, maintained, and provisioned independently of one another. This is known as Multi-Dimensional Scaling.

      You can perform the following actions:

      Action Example

      Deploy different services with different virtual machine types.

      Deploy the Data Service on VMs that have a large amount of memory. Deploy the Index Service on VMs that have a very high storage I/O rating.

      Scale a service up or down by adding or removing virtual machines.

      Add another VM to increase capacity when resource capacity is running low for one of the services.

      Scale a service up or down by changing the virtual machine type of an existing VM.

      Change the VM type to one with lower capacity when a service has a lot of excess resource capacity.

      Couchbase Versions

      New and upgraded databases are deployed with the latest patch version of Couchbase Server available on Couchbase Capella for the minor version deployed. Version upgrades are scheduled when they become available. You can reschedule maintenance upgrades.

      For more information about upgrades, see Upgrading a Database.

      See Also

      See the following pages for more information about managing databases: