Compose Database-as-a-Service Help and Documentation

Everything you need to know about Compose, Hosted or Enterprise, is here in our help system. Whether you run one database for your businesses' sole application or six different databases to support an entire corporation, we've got the information you need.

Data Browser for etcd2

etcdv2 is being deprecated

With the release of etcd3 from beta, Compose will soon no longer support etcd2 on the platform. The deprecation schedule is:
November 1st, 2017 - No more etcd2 provisions.
February 1st, 2018 - Official EOL
May 1st, 2018 - Start spinning down deployments.

Please plan on upgrading or deprovisioning your etcd2 deployments accordingly.

For a high-level view of why data browsers are available on Compose, and a full list of deployment types they are available on: Compose Deployments - Data Browsers.

Overview

The data browser on etcd provides access to parts of the etcd API from inside the Compose Console. It's an easy way to manage keys outside of curl.

Keys

The top level view is a listing of keys in the datastore along with their values. Click on the key to set or update its value. It is also possible to update the value of an existing key by clicking on the Set a Key button in the upper-right and filling in an existing key into the curl script.

List of key/values in the browser.

List of key/values in the browser.

To delete a key, click on it. Then on the upper-right, click on the Delete button. This deletes both the key and the value.

Setting a value to an existing key.

Setting a value to an existing key.

It is also possible to store directories in the keyspace, in addition to keys. Click on a directory to navigate through it. To update a value in the directory, click on its path and type the new value into the text box.

Deleting a directory and values.

Deleting a directory and values.

It is possible to delete an entire directory by clicking on the Delete button in the upper-right. This deletes all the values inside of it.

To navigate back through the directory, follow the breadcrumbs at the top.

Key directory structure.

Key directory structure.

Adding a New Key or Directory

To add a new key/value pair to the datastore, click on the Set a Key button in the upper-right. This creates a curl script with a PUT command. Fill in the key field and the value field. Note that the value field is required; it is not allowed to create a key without a value.

Adding a key via the browser.

Adding a key via the browser.

To create a new directory, type a path into the key field.

Adding a directory via the browser.

Adding a directory via the browser.

Below the command-line the optional parameter TTL is available.

Once the command is run, the key has been created and a text field appears with the value in it. If the value needs to be modified, enter the new value into the text field and click on Set Value. To return to the list of keys, click on either Keys in the upper-left of the view or on Browser from the sidebar.

Returning to the list of keys.

Returning to the list of keys.


Still Need Help?

If this article didn't solve things, summon a human and get some help.