Cluster and Data


    Having followed the sign-up process and deployed your first cluster, follow the steps below to explore Couchbase Capella — loading data, configuring your cluster, and connecting to it along the way.


    1. Click on the Projects tab on the left.

      This will show all the projects for your account. Projects are a great way to link clusters and users together for easier management.

    2. Click Trial - Project to open this project.

      With a project open, you will see a list of all clusters in the project, along with cluster health, cloud provider, and region information for each.

    3. Click Trial - Cluster to view the details of this cluster.



    With the cluster open, you will now see multiple tabs below the cluster name. It will default to Metrics. As this is your first time examining the cluster, no metrics are shown—​let’s add some.

    While you can add metrics one-by-one by clicking in the Add Metrics area, the easier path is to use the template that is set up with several predefined metrics.

    1. Click the blue Data Services link in the middle of the screen.

      This will add several metrics to your dashboard.


    Import Data

    To start looking at some data, we first need to import a sample. Let’s do that now.

    1. Click Tools  Import.

      Here you will see three sample data sets and their descriptions. We will use the Travel Sample. If you want to get a detailed description of the data, data model, and other information about the Travel Sample, click on the Learn More link.

    2. Click the Import button within the Travel Sample area. This will start loading the data, which takes about a minute.



    1. Click the Configuration tab.

    The Configuration tab shows settings like services, nodes, compute, and disk type.


    In a non-trial account, you can add and remove nodes, as well as easily make changes to hardware, memory, and storage. The ability to easily configure clusters makes it simple to scale horizontally and vertically.

    Following any configuration changes, Capella automatically rebalances your data across nodes. No changes are needed on the application side. Also, services can be assigned per node, a feature we call Multi-Dimensional Scaling. For example, you may want compute-optimized hardware for one service and memory-optimized hardware for another. This helps you performance match your application’s needs to the database and its infrastructure. By more efficiently using your hardware, you improve performance while also bringing down TCO.


    1. Click the Buckets tab.

    A bucket is a database within Couchbase. You can have more than one bucket. If you load all three datasets, then you will see them all listed under the Buckets tab. You can see lots of information about each bucket.


    We are going to make a change to the memory allocated to this bucket.

    1. Click on the name of the bucket. This will open a flyout with more details.

    2. In the flyout, click the Memory tab and change the default Memory Per Server Per Node value of 200 to 1000.

    3. Click Update.

      The changes are applied and the flyout closes. This update will make our queries faster later on.



    1. Click the Connect tab.

    This is where we will find information to establish an external connection to your Capella cluster.

    Listed in the Wide Area Network area, you will see your database endpoint. The endpoint in the screenshot below has been changed, so your endpoint will look a little different.


    Allowed IP Addresses

    You must add your own IP address to connect to your cluster.

    1. With the Connect tab open, click Manage Allowed IP.

    2. Click Add Allowed IP

    3. For this exercise, choose the Add Permanent IP block.

    4. Beside the IP Address/CIDR Block field, click Add My IP

    5. The IP address your computer is currently using will be filled into the IP Address/CIDR Block field.

    6. Optionally add a descriptive comment, then click the Add IP button. Your IP address is saved as an Allowed IP for connecting to your cluster.


    SDK Examples

    1. With the Connect tab open, click the SDK Examples link.

      This opens a flyout that provides details and sample connection code on the many SDKs for Capella.


    Database Credentials

    To connect an external application to Capella, you must define at least one set of credentials.

    1. Click the Manage Credentials link.

      This opens the Database Credentials page.

    2. Click Create Database Credential.


    This will allow you to set up new credentials.

    1. Enter a username and password.

    2. Now choose your buckets, scopes, and access type.

      Choose All Buckets, All Scopes, and Read/Write.

    3. Click Create.

    Congratulations. You finished this part of the tutorial. Now move on to the next section, run your first query.