Overview

The Apps Datastore offers a scalable, structured data storage solution within Datadog’s App Builder and Workflow Automation products. It supports CRUD (Create, Read, Update, and Delete) operations and integrates seamlessly with Datadog’s ecosystem to optimize persistent data storage without the need for external databases.

You can interact with a datastore using an app or a workflow, or you can use the UI in the Datadog App.

Prerequisites

To interact with the Apps Datastore, your Datadog account must have the following permissions, which are included in the Datadog Standard Role:

• apps_datastore_read - Allows read access to the data within the Apps Datastore.
• apps_datastore_write - Allows modification of data within the Apps Datastore, including adding, editing, and deleting records.

To use the Apps Datastore UI, you also need the following permission, which is also included in the Datadog Standard Role:

• apps_datastore_manage - Allows management of the Apps Datastore, including creating, updating, and deleting the datastore itself.

Create a datastore

To create a datastore:

1. Navigate to the Datastore page.

2. Click + New Datastore.

3. Enter a Name, a Primary Key, and optionally a Description for your datastore. The Primary Key must be a column name in your data where every data row has a unique value.

4. Optionally, to upload initial items to your datastore, use one of the following methods to copy a CSV file:

   • Drag and drop the file into the UI.
   • Click browse files to browse and select a file from your computer.
   • Copy a CSV file on your computer and use Ctrl/Cmd + V to paste it.

   The CSV file must include a header row with a column that matches your Primary Key.

5. Click Create.

6. To see your datastore in the list, click Refresh Results.

After you populate your datastore with data, you can:

• Search the datastore by using the Search box in the header.
• Click the name of a column to sort the datastore by that column’s data.

Edit a datastore

To edit a datastore, on the Datastore page, locate your datastore in the list. You can perform the following operations:

• To add a row, click the + (plus) icon. Fill in values for each field in the row, then click Create.
• To edit non-primary-key values in an existing row, hover over the row and click the Pencil (Edit) icon. Edit the desired values, then click Save.
• To delete an existing row, hover over the row and click the Trash (Delete) icon. Click Delete to confirm.

Reference a datastore

To use values from a datastore in a workflow or app:

1. On the Datastore page, locate your datastore in the list.
2. In the header of your datastore, click the Copy Datastore UUID button.
3. Use this UUID to reference your datastore in a workflow or app. Use the Delete item, Get item, List items, or Put item actions and provide the UUID as your Datastore ID.

Delete a datastore

To delete a datastore, click the Trash (Delete Datastore) icon in the header of the datastore you want to delete, then click Confirm to verify.

Further reading

Additional helpful documentation, links, and articles:

Build AppsDOCUMENTATION Build WorkflowsDOCUMENTATION